Guid.ToString Yöntem

Tanım

Ad Alanı:

System

Bütünleştirilmiş Kod:

System.Runtime.dll

Guid yapısının bu örneğinin değerinin dize gösterimini döndürür.

Aşırı Yüklemeler

ToString(String)	Sağlanan biçim tanımlayıcısına göre bu Guid örneğin değerinin dize gösterimini döndürür.
ToString()	Bu örneğin değerinin kayıt defteri biçiminde dize gösterimini döndürür.
ToString(String, IFormatProvider)	Sağlanan biçim belirticisi ve kültüre özgü biçim bilgilerine göre Guid sınıfının bu örneğinin değerinin dize gösterimini döndürür.

ToString(String)

Kaynak:

Guid.cs

Sağlanan biçim tanımlayıcısına göre bu Guid örneğin değerinin dize gösterimini döndürür.

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

Parametreler

format

String

Bu Guiddeğerinin nasıl biçimlendirildiğini gösteren tek biçim tanımlayıcısı. format parametresi "N", "D", "B", "P" veya "X" olabilir. format null veya boş bir dizeyse (""), "D" kullanılır.

Döndürülenler

String

Bu Guiddeğeri, belirtilen biçimde küçük harf onaltılık basamak dizisi olarak temsil edilir.

Özel durumlar

FormatException

format değeri null, boş bir dize (""), "N", "D", "B", "P" veya "X" değildir.

Açıklamalar

Aşağıdaki tabloda, format parametresi için kabul edilen biçim tanımlayıcıları gösterilmektedir. "0" bir rakamı temsil eder; kısa çizgiler ("-"), ayraçlar ("{", "}") ve parantezler ("(", ")") gösterildiği gibi görünür.

Belirticisi	Dönüş değerinin biçimi
N	32 basamak: 00000000000000000000000000000000
D	Kısa çizgilerle ayrılmış 32 basamak: 00000000-0000-0000-0000-000000000000
B	Küme ayracı içine alınmış, kısa çizgilerle ayrılmış 32 basamak: {00000000-0000-0000-0000-000000000000}
P	Parantez içine alınmış, kısa çizgilerle ayrılmış 32 basamak: (00000000-0000-0000-0000-000000000000)
X	Ayraç içine alınmış dört onaltılık değer; dördüncü değer de ayraç içine alınmış sekiz onaltılık değerin alt kümesidir: {0x00000000,0x0000,0x0000,{0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00}}

A ile f arasında onaltılık basamaklar, döndürülen dizede küçük harftir. Bunları büyük harfe dönüştürmek için döndürülen dizede String.ToUpper yöntemini çağırın.

ToString()

Kaynak:

Guid.cs

Bu örneğin değerinin kayıt defteri biçiminde dize gösterimini döndürür.

public:
 override System::String ^ ToString();

public override string ToString ();

override this.ToString : unit -> string

Public Overrides Function ToString () As String

Döndürülenler

String

Bu Guiddeğeri, aşağıdaki gibi "D" biçim tanımlayıcısı kullanılarak biçimlendirilir:

xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

burada GUID değeri, 8, 4, 4, 4 ve 12 basamaklı gruplarda küçük harf onaltılık basamaklar dizisi olarak gösterilir ve kısa çizgilerle ayrılır. Dönüş değeri örneği" 382c74c3-721d-4f34-80e5-57657b6cbc27" şeklindedir. Onaltılık basamakları bir ile f arasında büyük harfe dönüştürmek için, döndürülen dizede ToUpper() yöntemini çağırın.

Açıklamalar

Bu yöntem, tipik kullanım için yeterli olan varsayılan bir GUID biçimi sağlar; ancak, bu yöntemin format parametresini alan diğer sürümleri birkaç yaygın biçim varyasyonu sağlar.

ToString(String, IFormatProvider)

Kaynak:

Guid.cs

Sağlanan biçim belirticisi ve kültüre özgü biçim bilgilerine göre Guid sınıfının bu örneğinin değerinin dize gösterimini döndürür.

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

Parametreler

format

String

Bu Guiddeğerinin nasıl biçimlendirildiğini gösteren tek biçim tanımlayıcısı. format parametresi "N", "D", "B", "P" veya "X" olabilir. format null veya boş bir dizeyse (""), "D" kullanılır.

provider

IFormatProvider

(Ayrılmış) Kültüre özgü biçimlendirme bilgileri sağlayan bir nesne.

Döndürülenler

String

Bu Guiddeğeri, belirtilen biçimde küçük harf onaltılık basamak dizisi olarak temsil edilir.

Uygulamalar

ToString(String, IFormatProvider)

Özel durumlar

FormatException

format değeri null, boş bir dize (""), "N", "D", "B", "P" veya "X" değildir.

Açıklamalar

provider parametresi gelecekte kullanılmak üzere ayrılmıştır ve bu yöntemin yürütülmesine katkıda bulunmaz. yöntem çağrısında null geçirebilirsiniz.

Aşağıdaki tabloda, format parametresi için kabul edilen biçim tanımlayıcıları gösterilmektedir. "0" bir rakamı temsil eder; kısa çizgiler ("-"), ayraçlar ("{", "}") ve parantezler ("(", ")") gösterildiği gibi görünür.

Belirticisi	Dönüş değerinin biçimi
N	32 basamak: 00000000000000000000000000000000
D	Kısa çizgilerle ayrılmış 32 basamak: 00000000-0000-0000-0000-000000000000
B	Küme ayracı içine alınmış, kısa çizgilerle ayrılmış 32 basamak: {00000000-0000-0000-0000-000000000000}
P	Parantez içine alınmış, kısa çizgilerle ayrılmış 32 basamak: (00000000-0000-0000-0000-000000000000)
X	Ayraç içine alınmış dört onaltılık değer; dördüncü değer de ayraç içine alınmış sekiz onaltılık değerin alt kümesidir: {0x00000000,0x0000,0x0000,{0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00}}

A ile f arasında onaltılık basamaklar, döndürülen dizede küçük harftir. Bunları büyük harfe dönüştürmek için döndürülen dizede String.ToUpper yöntemini çağırın.

provider parametresi yoksayıldığı için özel biçimlendirme çözümü sağlamak için bunu kullanamazsınız. Guid değerini standart GUID biçim dizeleri tarafından desteklenmeyen bir biçimde bir dize olarak göstermek için, ICustomFormatter ve IFormatProvider arabirimlerini uygulayan bir provider nesnesiyle String.Format(IFormatProvider, String, Object[]) yöntemini çağırın. Daha fazla bilgi için Biçimlendirme Türleri makalesinin "ICustomFormatter ile Özel Biçimlendirme" bölümüne bakın.