XmlAttribute.Prefix XmlAttribute.Prefix XmlAttribute.Prefix XmlAttribute.Prefix Property

Definizione

Ottiene o imposta il prefisso dello spazio dei nomi del nodo.Gets or sets the namespace prefix of this node.

public:
 virtual property System::String ^ Prefix { System::String ^ get(); void set(System::String ^ value); };
public override string Prefix { get; set; }
member this.Prefix : string with get, set
Public Overrides Property Prefix As String

Valore della proprietà

Prefisso dello spazio dei nomi del nodo.The namespace prefix of this node. Se non è presente un prefisso, questa proprietà restituisce String.Empty.If there is no prefix, this property returns String.Empty.

Eccezioni

Il nodo è di sola lettura.This node is read-only.

Il prefisso specificato contiene un carattere non valido.The specified prefix contains an invalid character.

Il prefisso specificato non è valido.The specified prefix is malformed.

L'URI dello spazio dei nomi del nodo è null.The namespaceURI of this node is null.

Il prefisso specificato è "xml" e l'URI dello spazio dei nomi del nodo è diverso da "http://www.w3.org/XML/1998/namespace".The specified prefix is "xml", and the namespaceURI of this node is different from "http://www.w3.org/XML/1998/namespace".

Il nodo è un attributo, il prefisso specificato è "xmlns" e l'URI dello spazio dei nomi del nodo è diverso da "http://www.w3.org/2000/xmlns/".This node is an attribute, the specified prefix is "xmlns", and the namespaceURI of this node is different from "http://www.w3.org/2000/xmlns/".

Il nodo è un attributo e il valore qualifiedName del nome è "xmlns" [Namespaces].This node is an attribute, and the qualifiedName of this node is "xmlns" [Namespaces].

Esempi

Nell'esempio seguente vengono visualizzate informazioni su ogni nodo della raccolta di attributi.The following example displays information on each of the nodes in the attribute collection.

#using <System.Xml.dll>

using namespace System;
using namespace System::IO;
using namespace System::Xml;
int main()
{
   XmlDocument^ doc = gcnew XmlDocument;
   doc->LoadXml( "<book xmlns:bk='urn:samples' bk:genre='novel'><title>Pride And Prejudice</title></book>" );
   
   //Create an attribute collection.
   XmlAttributeCollection^ attrColl = doc->DocumentElement->Attributes;
   Console::WriteLine( "Display information on each of the attributes... \r\n" );
   System::Collections::IEnumerator^ myEnum = attrColl->GetEnumerator();
   while ( myEnum->MoveNext() )
   {
      XmlAttribute^ attr = safe_cast<XmlAttribute^>(myEnum->Current);
      Console::Write( "{0}:{1} = {2}", attr->Prefix, attr->LocalName, attr->Value );
      Console::WriteLine( "\t namespaceURI={0}", attr->NamespaceURI );
   }
}

using System;
using System.IO;
using System.Xml;

public class Sample
{
  public static void Main(){
  
    XmlDocument doc = new XmlDocument();
    doc.LoadXml("<book xmlns:bk='urn:samples' bk:genre='novel'>" +
                "<title>Pride And Prejudice</title>" +
                "</book>");      

    //Create an attribute collection.
    XmlAttributeCollection attrColl = doc.DocumentElement.Attributes;

    Console.WriteLine("Display information on each of the attributes... \r\n");
    foreach (XmlAttribute attr in attrColl){
       Console.Write("{0}:{1} = {2}", attr.Prefix, attr.LocalName, attr.Value);
       Console.WriteLine("\t namespaceURI=" + attr.NamespaceURI);
    }
  }
}
Imports System.IO
Imports System.Xml

public class Sample

  public shared sub Main()

    Dim doc as XmlDocument = new XmlDocument()
    doc.LoadXml("<book xmlns:bk='urn:samples' bk:genre='novel'>" & _
                "<title>Pride And Prejudice</title>" & _
                "</book>") 

    'Create an attribute collection.
    Dim attrColl as XmlAttributeCollection = doc.DocumentElement.Attributes

    Console.WriteLine("Display information on each of the attributes... ")
    Dim attr as XmlAttribute
    for each attr in attrColl
       Console.Write("{0}:{1} = {2}", attr.Prefix, attr.LocalName, attr.Value)
       Console.WriteLine("   namespaceURI=" + attr.NamespaceURI)
    next

  end sub
end class

Commenti

Poiché la modifica del prefisso di un attributo non comporta la modifica del relativo URI dello spazio dei nomi, la modifica del prefisso di un attributo con un valore predefinito non comporta la creazione di un nuovo attributo con il valore predefinito e il prefisso originale.Because changing the prefix of an attribute does not change its namespace URI, changing the prefix of an attribute that is known to have a default value does not create a new attribute with the default value and the original prefix.

Si applica a