XmlWriter.WriteStartAttribute Yöntem

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

Türetilmiş bir sınıfta geçersiz kılındığında, özniteliğin başlangıcını yazar.

Aşırı Yüklemeler

WriteStartAttribute(String, String, String)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen ön ek, yerel ad ve ad alanı URI'sine sahip bir özniteliğin başlangıcını yazar.
WriteStartAttribute(String)	Belirtilen yerel ada sahip bir özniteliğin başlangıcını yazar.
WriteStartAttribute(String, String)	Belirtilen yerel ad ve ad alanı URI'sine sahip bir özniteliğin başlangıcını yazar.

Açıklamalar

Bu yöntemin zaman uyumsuz sürümü için bkz WriteStartAttributeAsync. .

WriteStartAttribute(String, String, String)

Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen ön ek, yerel ad ve ad alanı URI'sine sahip bir özniteliğin başlangıcını yazar.

public:
 abstract void WriteStartAttribute(System::String ^ prefix, System::String ^ localName, System::String ^ ns);

public abstract void WriteStartAttribute (string prefix, string localName, string ns);

public abstract void WriteStartAttribute (string? prefix, string localName, string? ns);

abstract member WriteStartAttribute : string * string * string -> unit

Public MustOverride Sub WriteStartAttribute (prefix As String, localName As String, ns As String)

Parametreler

prefix

String

Özniteliğin ad alanı ön eki.

localName

String

Özniteliğin yerel adı.

ns

String

Özniteliğin ad alanı URI'si.

Özel durumlar

EncoderFallbackException

Arabellekte geçerli bir XML karakteri olan ancak çıkış kodlaması için geçerli olmayan bir karakter vardır. Örneğin, çıkış kodlaması ASCII ise, öğe ve öznitelik adları için yalnızca 0 ile 127 aralığındaki karakterleri kullanmanız gerekir. Geçersiz karakter bu yöntemin bağımsız değişkeninde veya arabelleğe yazan önceki yöntemlerin bağımsız değişkeninde olabilir. Bu tür karakterler mümkün olduğunda karakter varlığı başvuruları tarafından kaçış olarak kullanılır (örneğin, metin düğümlerinde veya öznitelik değerlerinde). Ancak, öğe ve öznitelik adlarında, açıklamalarda, işleme yönergelerinde veya CDATA bölümlerinde karakter varlığı başvurusuna izin verilmez.

InvalidOperationException

Önceki XmlWriter bir zaman uyumsuz işlem tamamlanmadan önce bir yöntem çağrıldı. Bu durumda, InvalidOperationException "Zaman uyumsuz bir işlem zaten devam ediyor" iletisiyle oluşturulur.

Açıklamalar

Bu yöntem, birden çok Write yöntemi kullanarak bir değer yazmanızı sağlar.

Bu yöntemin zaman uyumsuz sürümü için bkz WriteStartAttributeAsync. .

WriteStartAttribute(String)

Belirtilen yerel ada sahip bir özniteliğin başlangıcını yazar.

public:
 void WriteStartAttribute(System::String ^ localName);

public void WriteStartAttribute (string localName);

member this.WriteStartAttribute : string -> unit

Public Sub WriteStartAttribute (localName As String)

Parametreler

localName

String

Özniteliğin yerel adı.

Özel durumlar

InvalidOperationException

Yazar kapalı.

-veya-

Önceki XmlWriter bir zaman uyumsuz işlem tamamlanmadan önce bir yöntem çağrıldı. Bu durumda, InvalidOperationException "Zaman uyumsuz bir işlem zaten devam ediyor" iletisiyle oluşturulur.

EncoderFallbackException

Arabellekte geçerli bir XML karakteri olan ancak çıkış kodlaması için geçerli olmayan bir karakter vardır. Örneğin, çıkış kodlaması ASCII ise, öğe ve öznitelik adları için yalnızca 0 ile 127 aralığındaki karakterleri kullanmanız gerekir. Geçersiz karakter bu yöntemin bağımsız değişkeninde veya arabelleğe yazan önceki yöntemlerin bağımsız değişkeninde olabilir. Bu tür karakterler mümkün olduğunda karakter varlığı başvuruları tarafından kaçış olarak kullanılır (örneğin, metin düğümlerinde veya öznitelik değerlerinde). Ancak, öğe ve öznitelik adlarında, açıklamalarda, işleme yönergelerinde veya CDATA bölümlerinde karakter varlığı başvurusuna izin verilmez.

Açıklamalar

Bu yöntem, birden çok Write yöntemi kullanarak bir değer yazmanızı sağlar.

Bu yöntemin zaman uyumsuz sürümü için bkz WriteStartAttributeAsync. .

WriteStartAttribute(String, String)

Belirtilen yerel ad ve ad alanı URI'sine sahip bir özniteliğin başlangıcını yazar.

public:
 void WriteStartAttribute(System::String ^ localName, System::String ^ ns);

public void WriteStartAttribute (string localName, string ns);

public void WriteStartAttribute (string localName, string? ns);

member this.WriteStartAttribute : string * string -> unit

Public Sub WriteStartAttribute (localName As String, ns As String)

Parametreler

localName

String

Özniteliğin yerel adı.

ns

String

Özniteliğin ad alanı URI'si.

Özel durumlar

EncoderFallbackException

Arabellekte geçerli bir XML karakteri olan ancak çıkış kodlaması için geçerli olmayan bir karakter vardır. Örneğin, çıkış kodlaması ASCII ise, öğe ve öznitelik adları için yalnızca 0 ile 127 aralığındaki karakterleri kullanmanız gerekir. Geçersiz karakter bu yöntemin bağımsız değişkeninde veya arabelleğe yazan önceki yöntemlerin bağımsız değişkeninde olabilir. Bu tür karakterler mümkün olduğunda karakter varlığı başvuruları tarafından kaçış olarak kullanılır (örneğin, metin düğümlerinde veya öznitelik değerlerinde). Ancak, öğe ve öznitelik adlarında, açıklamalarda, işleme yönergelerinde veya CDATA bölümlerinde karakter varlığı başvurusuna izin verilmez.

InvalidOperationException

Önceki XmlWriter bir zaman uyumsuz işlem tamamlanmadan önce bir yöntem çağrıldı. Bu durumda, InvalidOperationException "Zaman uyumsuz bir işlem zaten devam ediyor" iletisiyle oluşturulur.

Örnekler

Bu yöntemi kullanan bir örnek için bkz XmlTextWriter.WriteStartAttribute .

Açıklamalar

Bu, , WriteQualifiedNameve gibi WriteStringbirden çok yazma yöntemi kullanarak öznitelik değeri yazmanızı sağlayan daha gelişmiş bir sürümüdürWriteAttributeString.

Bu yöntemin zaman uyumsuz sürümü için bkz WriteStartAttributeAsync. .

Ayrıca bkz.

• WriteEndAttribute()