CharSet 列挙体

.NET Framework クラス ライブラリ リファレンス

CharSet 列挙体

マーシャリングされた文字列で使用する文字セットを指定します。

名前空間: System.Runtime.InteropServices
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

<SerializableAttribute> _
<ComVisibleAttribute(True)> _
Public Enumeration CharSet

Visual Basic (使用法)

Dim instance As CharSet

C#

[SerializableAttribute] 
[ComVisibleAttribute(true)] 
public enum CharSet

C++

[SerializableAttribute] 
[ComVisibleAttribute(true)] 
public enum class CharSet

J#

/** @attribute SerializableAttribute() */ 
/** @attribute ComVisibleAttribute(true) */ 
public enum CharSet

JScript

SerializableAttribute 
ComVisibleAttribute(true) 
public enum CharSet

メンバ

	メンバ名	説明
	Ansi	マルチバイト文字として文字列をマーシャリングします。
	Auto	対象オペレーティング システムに適するように、自動的に文字列をマーシャリングします。Windows NT、Windows 2000、Windows XP、Windows Server 2003 ファミリの場合、既定値は Unicode です。Windows 98 および Windows Me の場合、既定値は Ansi です。共通言語ランタイムの既定値は Auto ですが、言語によってこの既定値がオーバーライドされることがあります。たとえば、C# の既定では、すべてのメソッドと型が Ansi としてマークされます。
	None	この値は今後使用しません。動作は CharSet.Ansi と同じです。
	Unicode	Unicode 2 バイト文字として文字列をマーシャリングします。

解説

アンマネージ文字列の型はいくつかあり、マネージ文字列の型は 1 つしかありませんので、マネージ文字列をアンマネージ コードにマーシャリングするときは、文字セットを使用してその方法を指定する必要があります。この列挙体は、文字セット オプションを提供し、DllImportAttribute および StructLayoutAttribute で使用されます。この列挙体に関連する文字列マーシャリングと名前一致の動作の詳細については、「文字セットの指定」を参照してください。

使用例

StructLayoutAttribute をマネージ定義に適用するときに CharSet 列挙体の値を指定する方法を次の例に示します。

Visual Basic

< StructLayout(LayoutKind.Sequential, CharSet := CharSet.Ansi)> _
 Public Structure MyPerson
    Public first As String
    Public last As String
 End Structure 'MyPerson

C#

[ StructLayout(LayoutKind.Sequential, CharSet=CharSet.Ansi)]
 public struct MyPerson 
 {
    public String first; 
    public String last;
 }

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
System.Runtime.InteropServices 名前空間
DllImportAttribute
StructLayoutAttribute