Guid.ToString Yöntem

Tanım

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

Aşırı Yüklemeler

Name Description
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 sınıfın Guid bu örneğinin değerinin dize gösterimini döndürür.

ToString(String)

Kaynak:
Guid.cs
Kaynak:
Guid.cs
Kaynak:
Guid.cs
Kaynak:
Guid.cs
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);
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 Parametre "N", "D", "B", "P" veya "X" olabilir. format ise null veya boş bir dize (""), "D" kullanılır.

Döndürülenler

Belirtilen biçimde küçük harf onaltılık basamak dizisi olarak temsil edilen bu Guiddeğerinin değeri.

Özel durumlar

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

Açıklamalar

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

Tanımlayıcı 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 yöntemini çağırın String.ToUpper .

Şunlara uygulanır

ToString()

Kaynak:
Guid.cs
Kaynak:
Guid.cs
Kaynak:
Guid.cs
Kaynak:
Guid.cs
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

Aşağıdaki gibi "D" biçim tanımlayıcısı kullanılarak biçimlendirilmiş bu Guiddeğerinin değeri:

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 yöntemini çağırın ToUpper() .

Açıklamalar

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

Şunlara uygulanır

ToString(String, IFormatProvider)

Kaynak:
Guid.cs
Kaynak:
Guid.cs
Kaynak:
Guid.cs
Kaynak:
Guid.cs
Kaynak:
Guid.cs

Sağlanan biçim belirticisi ve kültüre özgü biçim bilgilerine göre sınıfın Guid 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);
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 Parametre "N", "D", "B", "P" veya "X" olabilir. format ise null veya boş bir dize (""), "D" kullanılır.

provider
IFormatProvider

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

Döndürülenler

Belirtilen biçimde küçük harf onaltılık basamak dizisi olarak temsil edilen bu Guiddeğerinin değeri.

Uygulamalar

Özel durumlar

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

Açıklamalar

provider parametresi gelecekteki kullanım için ayrılmıştır ve bu yöntemin yürütülmesine katkıda bulunmaz. Yöntem çağrısını geçirebilirsiniz null .

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

Tanımlayıcı 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 yöntemini çağırın String.ToUpper .

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

Şunlara uygulanır