Guid.ToString Guid.ToString Guid.ToString Guid.ToString Method

定義

Guid 構造体のこのインスタンスの値を文字列形式で返します。Returns a string representation of the value of this instance of the Guid structure.

オーバーロード

ToString() ToString() ToString() ToString()

このインスタンスの値の文字列形式をレジストリ形式で返します。Returns a string representation of the value of this instance in registry format.

ToString(String) ToString(String) ToString(String) ToString(String)

指定した書式指定子に従って、この Guid インスタンスの値を文字列形式で返します。Returns a string representation of the value of this Guid instance, according to the provided format specifier.

ToString(String, IFormatProvider) ToString(String, IFormatProvider) ToString(String, IFormatProvider) ToString(String, IFormatProvider)

指定した書式指定子とカルチャ固有の書式情報に従って、Guid クラスのこのインスタンスの値を文字列形式で返します。Returns a string representation of the value of this instance of the Guid class, according to the provided format specifier and culture-specific format information.

ToString() ToString() ToString() ToString()

このインスタンスの値の文字列形式をレジストリ形式で返します。Returns a string representation of the value of this instance in registry format.

public:
 override System::String ^ ToString();
public override string ToString ();
override this.ToString : unit -> string
Public Overrides Function ToString () As String

戻り値

この Guid の値で、"D" 書式指定子で次のように書式設定されています。The value of this Guid, formatted by using the "D" format specifier as follows: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxxxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

ここで、GUID の値は、ハイフンで 8 桁、4 桁、4 桁、4 桁、および 12 桁のグループに区切られた小文字の 16 進数で表されます。where the value of the GUID is represented as a series of lowercase hexadecimal digits in groups of 8, 4, 4, 4, and 12 digits and separated by hyphens. 戻り値は、たとえば "382c74c3-721d-4f34-80e5-57657b6cbc27" のようになります。An example of a return value is "382c74c3-721d-4f34-80e5-57657b6cbc27". 16 進数の数字 a から f を大文字に変換するには、返された文字列に ToUpper() メソッドを呼び出します。To convert the hexadecimal digits from a through f to uppercase, call the ToUpper() method on the returned string.

注釈

このメソッドは、一般的な使用のための十分なである既定の GUID 形式を提供します。ただし、このメソッドの他のバージョンを受け取る、formatパラメーターがいくつかの一般的な形式バリエーションを提供します。This method provides a default GUID format that is sufficient for typical use; however, other versions of this method that take a format parameter provide a few common format variations.

ToString(String) ToString(String) ToString(String) ToString(String)

指定した書式指定子に従って、この Guid インスタンスの値を文字列形式で返します。Returns a string representation of the value of this Guid instance, according to the provided format specifier.

public:
 System::String ^ ToString(System::String ^ format);
public string ToString (string format);
override this.ToString : string -> string
Public Function ToString (format As String) As String

パラメーター

format
String String String String

この Guid の値の書式を指定する 1 文字の書式指定子。A single format specifier that indicates how to format the value of this Guid. format パラメーターには、"N"、"D"、"B"、"P"、または "X" を指定できます。The format parameter can be "N", "D", "B", "P", or "X". formatnull または空の文字列 ("") である場合は、"D" が使用されます。If format is null or an empty string (""), "D" is used.

戻り値

この Guid の値。指定した書式を使用して一連の小文字の 16 進数の数字で表されます。The value of this Guid, represented as a series of lowercase hexadecimal digits in the specified format.

例外

format の値は null、空の文字列 ("")、"N"、"D"、"B"、"P"、"X" ではありません。The value of format is not null, an empty string (""), "N", "D", "B", "P", or "X".

注釈

次の表に、承認済みの書式指定子について、formatパラメーター。The following table shows the accepted format specifiers for the format parameter. 「0」に 1 桁の数字を表しますハイフン ("-")、中かっこ ("{"、"}")、およびかっこ (「(",」)") ように表示されます。"0" represents a digit; hyphens ("-"), braces ("{", "}"), and parentheses ("(", ")") appear as shown.

指定子Specifier 戻り値の形式Format of return value
N 32 桁:32 digits:

0000000000000000000000000000000000000000000000000000000000000000
D ハイフンで区切られた 32 桁:32 digits separated by hyphens:

00000000-0000-0000-0000-00000000000000000000-0000-0000-0000-000000000000
B 中かっこで囲まれ、ハイフンで区切られた 32 桁:32 digits separated by hyphens, enclosed in braces:

{00000000-0000-0000-0000-000000000000}
P かっこで囲まれた、ハイフンで区切られた 32 桁:32 digits separated by hyphens, enclosed in parentheses:

(00000000-0000-0000-0000-000000000000)(00000000-0000-0000-0000-000000000000)
X 4 番目の値が中かっこで囲まれた 8 つの 16 進値のサブセットをかっこで囲まれた 4 つの 16 進値:Four hexadecimal values enclosed in braces, where the fourth value is a subset of eight hexadecimal values that is also enclosed in braces:

{0x00000000、0x0000、0x0000、{0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}}{0x00000000,0x0000,0x0000,{0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00}}

16 進数の数字 a から f は小文字で返される文字列です。The hexadecimal digits a through f are lowercase in the returned string. 大文字に変換を呼び出し、String.ToUpperメソッドで返される文字列。To convert them to uppercase, call the String.ToUpper method on the returned string.

ToString(String, IFormatProvider) ToString(String, IFormatProvider) ToString(String, IFormatProvider) ToString(String, IFormatProvider)

指定した書式指定子とカルチャ固有の書式情報に従って、Guid クラスのこのインスタンスの値を文字列形式で返します。Returns a string representation of the value of this instance of the Guid class, according to the provided format specifier and culture-specific format information.

public:
 virtual System::String ^ ToString(System::String ^ format, IFormatProvider ^ provider);
public string ToString (string format, IFormatProvider provider);
override this.ToString : string * IFormatProvider -> string
Public Function ToString (format As String, provider As IFormatProvider) As String

パラメーター

format
String String String String

この Guid の値の書式を指定する 1 文字の書式指定子。A single format specifier that indicates how to format the value of this Guid. format パラメーターには、"N"、"D"、"B"、"P"、または "X" を指定できます。The format parameter can be "N", "D", "B", "P", or "X". formatnull または空の文字列 ("") である場合は、"D" が使用されます。If format is null or an empty string (""), "D" is used.

provider
IFormatProvider IFormatProvider IFormatProvider IFormatProvider

(予約済み) カルチャ固有の書式情報を提供するオブジェクト。(Reserved) An object that supplies culture-specific formatting information.

戻り値

この Guid の値。指定した書式を使用して一連の小文字の 16 進数の数字で表されます。The value of this Guid, represented as a series of lowercase hexadecimal digits in the specified format.

実装

例外

format の値は null、空の文字列 ("")、"N"、"D"、"B"、"P"、"X" ではありません。The value of format is not null, an empty string (""), "N", "D", "B", "P", or "X".

注釈

providerパラメーターは将来使用するために予約されていると、このメソッドの実行には含まれません。The provider parameter is reserved for future use and does not contribute to the execution of this method. 渡すことができますnullメソッドの呼び出しで。You can pass null in the method call.

次の表に、承認済みの書式指定子について、formatパラメーター。The following table shows the accepted format specifiers for the format parameter. 「0」に 1 桁の数字を表しますハイフン ("-")、中かっこ ("{"、"}")、およびかっこ (「(",」)") ように表示されます。"0" represents a digit; hyphens ("-"), braces ("{", "}"), and parentheses ("(", ")") appear as shown.

指定子Specifier 戻り値の形式Format of return value
N 32 桁:32 digits:

0000000000000000000000000000000000000000000000000000000000000000
D ハイフンで区切られた 32 桁:32 digits separated by hyphens:

00000000-0000-0000-0000-00000000000000000000-0000-0000-0000-000000000000
B 中かっこで囲まれ、ハイフンで区切られた 32 桁:32 digits separated by hyphens, enclosed in braces:

{00000000-0000-0000-0000-000000000000}
P かっこで囲まれた、ハイフンで区切られた 32 桁:32 digits separated by hyphens, enclosed in parentheses:

(00000000-0000-0000-0000-000000000000)(00000000-0000-0000-0000-000000000000)
X 4 番目の値が中かっこで囲まれた 8 つの 16 進値のサブセットをかっこで囲まれた 4 つの 16 進値:Four hexadecimal values enclosed in braces, where the fourth value is a subset of eight hexadecimal values that is also enclosed in braces:

{0x00000000、0x0000、0x0000、{0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}}{0x00000000,0x0000,0x0000,{0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00}}

16 進数の数字 a から f は小文字で返される文字列です。The hexadecimal digits a through f are lowercase in the returned string. 大文字に変換を呼び出し、String.ToUpperメソッドで返される文字列。To convert them to uppercase, call the String.ToUpper method on the returned string.

providerパラメーターは無視され、それを使用して、カスタムの書式設定ソリューションを提供することはできません。Because the provider parameter is ignored, you cannot use it to provide a custom formatting solution. 表す、Guid標準 GUID 書式指定文字列の呼び出しでサポートされていない形式の文字列として値、String.Format(IFormatProvider, String, Object[])メソッドをprovider両方を実装するオブジェクト、ICustomFormatterIFormatProviderインターフェイス。To represent a Guid value as a string in a format that isn't supported by the standard GUID format strings, call the String.Format(IFormatProvider, String, Object[]) method with a provider object that implements both the ICustomFormatter and IFormatProvider interfaces. 詳細については、「ICustomFormatter をカスタム書式設定」セクションを参照してください、型の書式設定記事。For more information, see the "Custom Formatting with ICustomFormatter" section in the Formatting Types article.

適用対象