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" は数字を表します。ハイフン ("-")、中かっこ ("{"、"}")、かっこ ("("、")") が表示されます。"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つの16進値が中かっこで囲まれています。4番目の値は、中かっこで囲まれた8つの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}}

A から f までの16進数字は、返される文字列では小文字です。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" は数字を表します。ハイフン ("-")、中かっこ ("{"、"}")、かっこ ("("、")") が表示されます。"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つの16進値が中かっこで囲まれています。4番目の値は、中かっこで囲まれた8つの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}}

A から f までの16進数字は、返される文字列では小文字です。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インターフェイスとIFormatProviderインターフェイスのICustomFormatter両方を実装するオブジェクトを使用してメソッドを呼び出します。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.

適用対象