XmlWriter.WriteQualifiedName(String, String) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
派生クラスでオーバーライドされると、名前空間の限定名を書き込みます。 このメソッドは、指定した名前空間のスコープ内にあるプレフィックスを検索します。
public:
virtual void WriteQualifiedName(System::String ^ localName, System::String ^ ns);
public:
abstract void WriteQualifiedName(System::String ^ localName, System::String ^ ns);
public virtual void WriteQualifiedName (string localName, string ns);
public virtual void WriteQualifiedName (string localName, string? ns);
public abstract void WriteQualifiedName (string localName, string ns);
abstract member WriteQualifiedName : string * string -> unit
override this.WriteQualifiedName : string * string -> unit
abstract member WriteQualifiedName : string * string -> unit
Public Overridable Sub WriteQualifiedName (localName As String, ns As String)
Public MustOverride Sub WriteQualifiedName (localName As String, ns As String)
パラメーター
- localName
- String
書き込むローカル名。
- ns
- String
名前の名前空間 URI。
例外
先行の非同期操作が完了する前に、XmlWriter メソッドが呼び出されました。 この場合、「非同期操作が既に実行されています」というメッセージと共に InvalidOperationException がスローされます。
例
この例では、次の要素を書き込みます。
<root xmlns:x="urn:abc">
<item href="#x:test"/>
</root>
XmlWriterSettings settings = new XmlWriterSettings();
settings.Indent = true;
settings.OmitXmlDeclaration = true;
using (XmlWriter writer = XmlWriter.Create(Console.Out, settings))
{
writer.WriteStartElement("root");
writer.WriteAttributeString("xmlns", "x", null, "urn:abc");
writer.WriteStartElement("item");
writer.WriteStartAttribute("href", null);
writer.WriteString("#");
writer.WriteQualifiedName("test", "urn:abc");
writer.WriteEndAttribute();
writer.WriteEndElement();
writer.WriteEndElement();
}
Dim settings As New XmlWriterSettings()
settings.Indent = True
settings.OmitXmlDeclaration = True
Using writer As XmlWriter = XmlWriter.Create(Console.Out, settings)
writer.WriteStartElement("root")
writer.WriteAttributeString("xmlns", "x", Nothing, "urn:abc")
writer.WriteStartElement("item")
writer.WriteStartAttribute("href", Nothing)
writer.WriteString("#")
writer.WriteQualifiedName("test", "urn:abc")
writer.WriteEndAttribute()
writer.WriteEndElement()
writer.WriteEndElement()
End Using
注釈
現在の既定の名前空間にマップされている場合 ns
、プレフィックスは生成されません。
属性値を書き込むときに、 が見つからない場合 ns
、このメソッドはプレフィックスを生成します。 要素コンテンツを書き込むときに、 が見つからない場合 ns
は例外をスローします。
Note
から XmlWriter 派生したクラスがオーバーライドされない場合、このメソッド localName
は有効な W3C XML 名としてチェックされません。 このような場合、このメソッドを呼び出す前に、メソッドによって IsName 文字列の有効性を確認できます。
このメソッドの非同期バージョンについては、「」を参照してください WriteQualifiedNameAsync。
適用対象
.NET
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示