Guid.IFormattable.ToString(String, IFormatProvider) Yöntem

Tanım

Ad Alanı:

System

Bütünleştirilmiş Kod:

System.Runtime.dll

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

 virtual System::String ^ System.IFormattable.ToString(System::String ^ format, IFormatProvider ^ provider) = IFormattable::ToString;

string IFormattable.ToString (string format, IFormatProvider provider);

abstract member System.IFormattable.ToString : string * IFormatProvider -> string
override this.System.IFormattable.ToString : string * IFormatProvider -> string

Function ToString (format As String, provider As IFormatProvider) As String Implements IFormattable.ToString

Parametreler

format

String

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

provider

IFormatProvider

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

Döndürülenler

String

Bunun Guid değeri, belirtilen biçimdeki küçük harf onaltılık basamaklardan oluşan bir dizi olarak temsil edilir.

Uygulamalar

ToString(String, IFormatProvider)

Özel durumlar

FormatException

değeri format null, boş bir dize ("") veya aşağıdaki tek biçim tanımlayıcılarından biri değildir:"N", "D", "B", "P" veya "X".

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ını geçirebilirsiniz null .

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

Belirleyici	Dönüş değerinin biçimi
N	32 basamak: 00000000000000000000000000000000
D	tire ile ayrılmış 32 basamak: 00000000-0000-0000-0000-000000000000
B	Küme ayraçları içinde, tirelerle ayrılmış 32 basamak: {00000000-0000-0000-0000-000000000000}
P	Parantez içinde, tirelerle ile ayrılmış 32 basamak: (00000000-0000-0000-0000-000000000000)
X	Dördüncü değerin ayraç içindeki sekiz onaltılık değerin bir alt kümesi olduğu, küme ayracı içinde dört onaltılık değer: {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 parametresi yoksayıldığı için, özel biçimlendirme çözümü sağlamak için bunu 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 IFormatProvider hem de ICustomFormatter arabirimlerini uygulayan bir provider nesneyle yöntemini çağırınString.Format(IFormatProvider, String, Object[]). Daha fazla bilgi için Biçimlendirme Türleri makalesinin "ICustomFormatter ile Özel Biçimlendirme" bölümüne bakın.