XmlNodeReader.ReadElementContentAsBase64(Byte[], Int32, Int32) Yöntem

Başvuru

Tanım

Ad Alanı:: System.Xml

Bütünleştirilmiş Kod:: System.Xml.ReaderWriter.dll

Bütünleştirilmiş Kod:: System.Xml.dll

Bütünleştirilmiş Kod:: netstandard.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

öğesini okur ve Base64 içeriğinin kodunu çözer.

public:
 override int ReadElementContentAsBase64(cli::array <System::Byte> ^ buffer, int index, int count);

public override int ReadElementContentAsBase64 (byte[] buffer, int index, int count);

override this.ReadElementContentAsBase64 : byte[] * int * int -> int

Public Overrides Function ReadElementContentAsBase64 (buffer As Byte(), index As Integer, count As Integer) As Integer

Parametreler

buffer: Byte[]

Sonuçta elde edilen metnin kopyalandığı arabellek. Bu değer olamaz null.

index: Int32

Sonucu kopyalamaya başlanacak arabelleğe uzaklık.

count: Int32

Arabelleğe kopyalanacak bayt sayısı üst sınırı. Kopyalanan gerçek bayt sayısı bu yöntemden döndürülür.

Döndürülenler

Int32

Arabelleğe yazılan bayt sayısı.

Özel durumlar

ArgumentNullException

buffer değeri null olur.

InvalidOperationException

Geçerli düğüm bir öğe düğümü değil.

ArgumentOutOfRangeException

Arabelleğe veya dizin + sayı dizinine ayrılan arabellek boyutundan daha büyük.

XmlException

öğesi karışık içerik içeriyor.

FormatException

İçerik istenen türe dönüştürülemiyor.

Örnekler

Bu yöntemi kullanarak bir örnek görmek için bkz XmlReader.ReadElementContentAsBase64 . .

Açıklamalar

Not

.NET Framework 2.0'da önerilen yöntem, sınıfını XmlReaderSettings ve Create yöntemini kullanarak örnekler oluşturmaktırXmlReader. Bu, .NET Framework sunulan tüm yeni özelliklerden tam olarak yararlanmanızı sağlar. Daha fazla bilgi için başvuru sayfasındaki Açıklamalar bölümüne XmlReader bakın.

Bu yöntem içeriği okur, Base64 kodlamasını kullanarak kodunu çözer ve kodu çözülen ikili baytları (örneğin, satır içi Base64 kodlanmış GIF görüntüsü) arabelleğe döndürür. Daha fazla bilgi için bkz. RFC 1521, "MIME (Çok Amaçlı İnternet Posta Uzantıları) Bölüm Bir: İnternet İleti Gövdelerinin Biçimini Belirtme ve Açıklama Mekanizmaları". RFC'leri Açıklama İsteği Web sitesinden alabilirsiniz.

Bu yöntem yalnızca basit içerik öğelerini okuyabilir. öğesi metin, boşluk, önemli boşluk, CDATA bölümleri, açıklamalar ve işleme yönergeleri içerebilir. Ayrıca otomatik olarak genişletilen varlık başvuruları da içerebilir. öğesi alt öğelere sahip olamaz.

Bu yöntem yöntemine ReadContentAsBase64 çok benzer, ancak yalnızca öğe düğümü türlerinde çağrılabilir.

Sayı değeri belgedeki bayt sayısından yüksekse veya belgedeki bayt sayısına eşitse, XmlNodeReader belgedeki kalan tüm baytları okur ve okunan bayt sayısını döndürür. Sonraki ReadElementContentAsBase64 yöntem çağrısı sıfır döndürür ve okuyucuyu düğümün ardından düğüme EndElement taşır.

Tüm öğe içeriği tüketilmeden önce çağrısı Read yaparsanız, okuyucu ilk içerik tüketilmiş ve yöntemi Read çağrılmış gibi davranabilir. Bu, okuyucunun son öğeyle karşılaşılana kadar tüm metni okuduğu anlamına gelir. Ardından bitiş etiketi düğümünü okur, sonraki düğümü okur ve ardından kendisini sonraki düğüme yerleştirir.

Şunlara uygulanır

Aracılığıyla paylaş