XmlWriter.WriteStartAttribute 메서드

정의

네임스페이스:

System.Xml

어셈블리:

System.Xml.ReaderWriter.dll

어셈블리:

System.Xml.dll

어셈블리:

netstandard.dll

파생 클래스에서 재정의될 때 특성의 시작을 작성합니다.

오버로드

WriteStartAttribute(String, String, String)	파생 클래스에서 재정의되면 지정된 접두사, 로컬 이름 및 네임스페이스 URI를 사용하여 특성의 시작 부분을 작성합니다.
WriteStartAttribute(String)	지정된 로컬 이름을 사용하여 특성의 시작 부분을 작성합니다.
WriteStartAttribute(String, String)	지정된 로컬 이름과 네임스페이스 URI를 사용하여 특성의 시작 부분을 작성합니다.

설명

이 메서드의 비동기 버전은 다음을 참조하세요 WriteStartAttributeAsync.

WriteStartAttribute(String, String, String)

파생 클래스에서 재정의되면 지정된 접두사, 로컬 이름 및 네임스페이스 URI를 사용하여 특성의 시작 부분을 작성합니다.

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)

매개 변수

prefix

String

특성의 네임스페이스 접두사입니다.

localName

String

특성의 로컬 이름입니다.

ns

String

특성의 네임스페이스 URI입니다.

예외

EncoderFallbackException

유효한 XML 문자이나 출력 인코딩에는 유효하지 않은 버퍼에 문자가 있습니다. 예를 들어, 출력 인코딩이 ASCII인 경우, 요소 및 특성 이름에 대해서는 0부터 127까지 범주의 문자만 사용해야 합니다. 유효하지 않은 문자가 이 메서드의 인수 안이나 버퍼에 쓰고 있었던 이전 메서드의 인수 안에 있을지도 모릅니다. 이러한 문자는 가능한 경우 (예를 들어, 텍스트 노드 또는 특성 값에서) 문자 엔터티 참조에 의해 이스케이프됩니다. 그러나, 문자 엔터티 참조가 요소 및 특성 이름, 주석, 처리 명령, 또는 CDATA 섹션에서는 허용되지 않습니다.

InvalidOperationException

이전 비동기 작업이 완료되기 전에 XmlWriter 메서드가 호출되었습니다. 이 경우 “비동기 작업이 이미 진행 중입니다.” 메시지를 나타내며 InvalidOperationException이 throw됩니다.

설명

이 메서드를 사용하면 여러 Write 메서드를 사용하여 값을 작성할 수 있습니다.

이 메서드의 비동기 버전은 다음을 참조하세요 WriteStartAttributeAsync.

WriteStartAttribute(String)

지정된 로컬 이름을 사용하여 특성의 시작 부분을 작성합니다.

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

public void WriteStartAttribute (string localName);

member this.WriteStartAttribute : string -> unit

Public Sub WriteStartAttribute (localName As String)

매개 변수

localName

String

특성의 로컬 이름입니다.

예외

InvalidOperationException

작성기가 닫힌 경우

또는

이전 비동기 작업이 완료되기 전에 XmlWriter 메서드가 호출되었습니다. 이 경우 “비동기 작업이 이미 진행 중입니다.” 메시지를 나타내며 InvalidOperationException이 throw됩니다.

EncoderFallbackException

유효한 XML 문자이나 출력 인코딩에는 유효하지 않은 버퍼에 문자가 있습니다. 예를 들어, 출력 인코딩이 ASCII인 경우, 요소 및 특성 이름에 대해서는 0부터 127까지 범주의 문자만 사용해야 합니다. 유효하지 않은 문자가 이 메서드의 인수 안이나 버퍼에 쓰고 있었던 이전 메서드의 인수 안에 있을지도 모릅니다. 이러한 문자는 가능한 경우 (예를 들어, 텍스트 노드 또는 특성 값에서) 문자 엔터티 참조에 의해 이스케이프됩니다. 그러나, 문자 엔터티 참조가 요소 및 특성 이름, 주석, 처리 명령, 또는 CDATA 섹션에서는 허용되지 않습니다.

설명

이 메서드를 사용하면 여러 Write 메서드를 사용하여 값을 작성할 수 있습니다.

이 메서드의 비동기 버전은 다음을 참조하세요 WriteStartAttributeAsync.

WriteStartAttribute(String, String)

지정된 로컬 이름과 네임스페이스 URI를 사용하여 특성의 시작 부분을 작성합니다.

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)

매개 변수

localName

String

특성의 로컬 이름입니다.

ns

String

특성의 네임스페이스 URI입니다.

예외

EncoderFallbackException

유효한 XML 문자이나 출력 인코딩에는 유효하지 않은 버퍼에 문자가 있습니다. 예를 들어, 출력 인코딩이 ASCII인 경우, 요소 및 특성 이름에 대해서는 0부터 127까지 범주의 문자만 사용해야 합니다. 유효하지 않은 문자가 이 메서드의 인수 안이나 버퍼에 쓰고 있었던 이전 메서드의 인수 안에 있을지도 모릅니다. 이러한 문자는 가능한 경우 (예를 들어, 텍스트 노드 또는 특성 값에서) 문자 엔터티 참조에 의해 이스케이프됩니다. 그러나, 문자 엔터티 참조가 요소 및 특성 이름, 주석, 처리 명령, 또는 CDATA 섹션에서는 허용되지 않습니다.

InvalidOperationException

이전 비동기 작업이 완료되기 전에 XmlWriter 메서드가 호출되었습니다. 이 경우 “비동기 작업이 이미 진행 중입니다.” 메시지를 나타내며 InvalidOperationException이 throw됩니다.

예제

이 메서드를 사용하는 예제를 참조 XmlTextWriter.WriteStartAttribute 하세요.

설명

보다 고급 버전 WriteAttributeString 이므로 여러 쓰기 메서드(예: WriteStringWriteQualifiedName등)를 사용하여 특성 값을 작성할 수 있습니다.

이 메서드의 비동기 버전은 다음을 참조하세요 WriteStartAttributeAsync.

추가 정보

• WriteEndAttribute()