XmlWriter.WriteStartAttribute XmlWriter.WriteStartAttribute XmlWriter.WriteStartAttribute XmlWriter.WriteStartAttribute Method

정의

파생 클래스에서 재정의될 때 특성의 시작을 작성합니다.When overridden in a derived class, writes the start of an attribute.

오버로드

WriteStartAttribute(String, String, String) WriteStartAttribute(String, String, String) WriteStartAttribute(String, String, String) WriteStartAttribute(String, String, String)

파생 클래스에서 재정의되면 지정된 접두사, 로컬 이름 및 네임스페이스 URI를 사용하여 특성의 시작 부분을 작성합니다.When overridden in a derived class, writes the start of an attribute with the specified prefix, local name, and namespace URI.

WriteStartAttribute(String) WriteStartAttribute(String) WriteStartAttribute(String) WriteStartAttribute(String)

지정된 로컬 이름을 사용하여 특성의 시작 부분을 작성합니다.Writes the start of an attribute with the specified local name.

WriteStartAttribute(String, String) WriteStartAttribute(String, String) WriteStartAttribute(String, String) WriteStartAttribute(String, String)

지정된 로컬 이름과 네임스페이스 URI를 사용하여 특성의 시작 부분을 작성합니다.Writes the start of an attribute with the specified local name and namespace URI.

설명

이 메서드의 비동기 버전을 참조 하세요. WriteStartAttributeAsync합니다.For the asynchronous version of this method, see WriteStartAttributeAsync.

WriteStartAttribute(String, String, String) WriteStartAttribute(String, String, String) WriteStartAttribute(String, String, String) WriteStartAttribute(String, String, String)

파생 클래스에서 재정의되면 지정된 접두사, 로컬 이름 및 네임스페이스 URI를 사용하여 특성의 시작 부분을 작성합니다.When overridden in a derived class, writes the start of an attribute with the specified prefix, local name, and namespace URI.

public:
 abstract void WriteStartAttribute(System::String ^ prefix, System::String ^ localName, System::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 String String String

특성의 네임스페이스 접두사입니다.The namespace prefix of the attribute.

localName
String String String String

특성의 로컬 이름입니다.The local name of the attribute.

ns
String String String String

특성의 네임스페이스 URI입니다.The namespace URI for the attribute.

예외

유효한 XML 문자이나 출력 인코딩에는 유효하지 않은 버퍼에 문자가 있습니다.There is a character in the buffer that is a valid XML character but is not valid for the output encoding. 예를 들어, 출력 인코딩이 ASCII인 경우, 요소 및 특성 이름에 대해서는 0부터 127까지 범주의 문자만 사용해야 합니다.For example, if the output encoding is ASCII, you should only use characters from the range of 0 to 127 for element and attribute names. 유효하지 않은 문자가 이 메서드의 인수 안이나 버퍼에 쓰고 있었던 이전 메서드의 인수 안에 있을지도 모릅니다.The invalid character might be in the argument of this method or in an argument of previous methods that were writing to the buffer. 이러한 문자는 가능한 경우 (예를 들어, 텍스트 노드 또는 특성 값에서) 문자 엔터티 참조에 의해 이스케이프됩니다.Such characters are escaped by character entity references when possible (for example, in text nodes or attribute values). 그러나, 문자 엔터티 참조가 요소 및 특성 이름, 주석, 처리 명령, 또는 CDATA 섹션에서는 허용되지 않습니다.However, the character entity reference is not allowed in element and attribute names, comments, processing instructions, or CDATA sections.

이전 비동기 작업이 완료되기 전에 XmlWriter 메서드가 호출되었습니다.An XmlWriter method was called before a previous asynchronous operation finished. 이 경우 “비동기 작업이 이미 진행 중입니다.” 메시지를 나타내며 InvalidOperationException이 throw됩니다.In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

설명

이 메서드를 사용 하면 여러 쓰기 메서드를 사용 하 여 값을 쓸 수 있습니다.This method enables you to write a value using multiple Write methods.

이 메서드의 비동기 버전을 참조 하세요. WriteStartAttributeAsync합니다.For the asynchronous version of this method, see WriteStartAttributeAsync.

WriteStartAttribute(String) WriteStartAttribute(String) WriteStartAttribute(String) WriteStartAttribute(String)

지정된 로컬 이름을 사용하여 특성의 시작 부분을 작성합니다.Writes the start of an attribute with the specified local name.

public:
 void WriteStartAttribute(System::String ^ localName);
public void WriteStartAttribute (string localName);
member this.WriteStartAttribute : string -> unit
Public Sub WriteStartAttribute (localName As String)

매개 변수

localName
String String String String

특성의 로컬 이름입니다.The local name of the attribute.

예외

작성기가 닫힌 경우The writer is closed.

또는-or-

이전 비동기 작업이 완료되기 전에 XmlWriter 메서드가 호출되었습니다.An XmlWriter method was called before a previous asynchronous operation finished. 이 경우 “비동기 작업이 이미 진행 중입니다.” 메시지를 나타내며 InvalidOperationException이 throw됩니다.In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

유효한 XML 문자이나 출력 인코딩에는 유효하지 않은 버퍼에 문자가 있습니다.There is a character in the buffer that is a valid XML character but is not valid for the output encoding. 예를 들어, 출력 인코딩이 ASCII인 경우, 요소 및 특성 이름에 대해서는 0부터 127까지 범주의 문자만 사용해야 합니다.For example, if the output encoding is ASCII, you should only use characters from the range of 0 to 127 for element and attribute names. 유효하지 않은 문자가 이 메서드의 인수 안이나 버퍼에 쓰고 있었던 이전 메서드의 인수 안에 있을지도 모릅니다.The invalid character might be in the argument of this method or in an argument of previous methods that were writing to the buffer. 이러한 문자는 가능한 경우 (예를 들어, 텍스트 노드 또는 특성 값에서) 문자 엔터티 참조에 의해 이스케이프됩니다.Such characters are escaped by character entity references when possible (for example, in text nodes or attribute values). 그러나, 문자 엔터티 참조가 요소 및 특성 이름, 주석, 처리 명령, 또는 CDATA 섹션에서는 허용되지 않습니다.However, the character entity reference is not allowed in element and attribute names, comments, processing instructions, or CDATA sections.

설명

이 메서드를 사용 하면 여러 쓰기 메서드를 사용 하 여 값을 쓸 수 있습니다.This method enables you to write a value using multiple Write methods.

이 메서드의 비동기 버전을 참조 하세요. WriteStartAttributeAsync합니다.For the asynchronous version of this method, see WriteStartAttributeAsync.

WriteStartAttribute(String, String) WriteStartAttribute(String, String) WriteStartAttribute(String, String) WriteStartAttribute(String, String)

지정된 로컬 이름과 네임스페이스 URI를 사용하여 특성의 시작 부분을 작성합니다.Writes the start of an attribute with the specified local name and namespace URI.

public:
 void WriteStartAttribute(System::String ^ localName, System::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 String String String

특성의 로컬 이름입니다.The local name of the attribute.

ns
String String String String

특성의 네임스페이스 URI입니다.The namespace URI of the attribute.

예외

유효한 XML 문자이나 출력 인코딩에는 유효하지 않은 버퍼에 문자가 있습니다.There is a character in the buffer that is a valid XML character but is not valid for the output encoding. 예를 들어, 출력 인코딩이 ASCII인 경우, 요소 및 특성 이름에 대해서는 0부터 127까지 범주의 문자만 사용해야 합니다.For example, if the output encoding is ASCII, you should only use characters from the range of 0 to 127 for element and attribute names. 유효하지 않은 문자가 이 메서드의 인수 안이나 버퍼에 쓰고 있었던 이전 메서드의 인수 안에 있을지도 모릅니다.The invalid character might be in the argument of this method or in an argument of previous methods that were writing to the buffer. 이러한 문자는 가능한 경우 (예를 들어, 텍스트 노드 또는 특성 값에서) 문자 엔터티 참조에 의해 이스케이프됩니다.Such characters are escaped by character entity references when possible (for example, in text nodes or attribute values). 그러나, 문자 엔터티 참조가 요소 및 특성 이름, 주석, 처리 명령, 또는 CDATA 섹션에서는 허용되지 않습니다.However, the character entity reference is not allowed in element and attribute names, comments, processing instructions, or CDATA sections.

이전 비동기 작업이 완료되기 전에 XmlWriter 메서드가 호출되었습니다.An XmlWriter method was called before a previous asynchronous operation finished. 이 경우 “비동기 작업이 이미 진행 중입니다.” 메시지를 나타내며 InvalidOperationException이 throw됩니다.In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

예제

참조 XmlTextWriter.WriteStartAttribute 이 메서드를 사용 하는 예제입니다.See XmlTextWriter.WriteStartAttribute for an example using this method.

설명

고급 버전 WriteAttributeString 와 같은 여러 write 메서드를 사용 하 여 특성 값을 작성할 수 있도록 WriteString, WriteQualifiedName등입니다.This is a more advanced version of WriteAttributeString that allows you to write an attribute value using multiple write methods, such as WriteString, WriteQualifiedName, and so on.

이 메서드의 비동기 버전을 참조 하세요. WriteStartAttributeAsync합니다.For the asynchronous version of this method, see WriteStartAttributeAsync.

추가 정보

적용 대상