XmlElement.SetAttribute Metodo

Definizione

Imposta il valore dell'attributo specificato.Sets the value of the specified attribute.

Overload

SetAttribute(String, String)

Imposta il valore dell'attributo con il nome specificato.Sets the value of the attribute with the specified name.

SetAttribute(String, String, String)

Imposta il valore dell'attributo con il nome locale e l'URI dello spazio dei nomi specificati.Sets the value of the attribute with the specified local name and namespace URI.

SetAttribute(String, String)

Imposta il valore dell'attributo con il nome specificato.Sets the value of the attribute with the specified name.

public:
 virtual void SetAttribute(System::String ^ name, System::String ^ value);
public virtual void SetAttribute (string name, string value);
abstract member SetAttribute : string * string -> unit
override this.SetAttribute : string * string -> unit
Public Overridable Sub SetAttribute (name As String, value As String)

Parametri

name
String

Nome dell'attributo da creare o modificare.The name of the attribute to create or alter. Si tratta di un nome completo.This is a qualified name. Se il nome contiene i due punti, viene analizzato nei componenti del nome locale e del prefisso.If the name contains a colon it is parsed into prefix and local name components.

value
String

Valore da impostare per l'attributo.The value to set for the attribute.

Eccezioni

Il nome specificato contiene un carattere non valido.The specified name contains an invalid character.

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

Commenti

Se nell'elemento è già presente un attributo con lo stesso nome, il relativo valore viene modificato in quello di value.If an attribute with the same name is already present in the element, its value is changed to that of value. value è una stringa semplice.value is a simple string. Non viene analizzato durante l'impostazione.It is not parsed as it is being set. Qualsiasi markup, ad esempio la sintassi da riconoscere come riferimento a entità, viene trattato come testo letterale e deve essere correttamente sottoposto a escape dall'implementazione quando viene scritto. Per assegnare un valore di attributo che contiene riferimenti a entità, l'utente deve creare un nodo XmlAttribute più tutti i nodi XmlText e XmlEntityReference, compilare il sottoalbero appropriato e utilizzare SetAttributeNode per assegnarlo come valore di un attributo.Any markup, such as syntax to be recognized as an entity reference, is treated as literal text and needs to be properly escaped by the implementation when it is written out. In order to assign an attribute value that contains entity references, the user must create an XmlAttribute node plus any XmlText and XmlEntityReference nodes, build the appropriate subtree and use SetAttributeNode to assign it as the value of an attribute.

SetAttribute(String, String, String)

Imposta il valore dell'attributo con il nome locale e l'URI dello spazio dei nomi specificati.Sets the value of the attribute with the specified local name and namespace URI.

public:
 virtual System::String ^ SetAttribute(System::String ^ localName, System::String ^ namespaceURI, System::String ^ value);
public virtual string SetAttribute (string localName, string namespaceURI, string value);
abstract member SetAttribute : string * string * string -> string
override this.SetAttribute : string * string * string -> string
Public Overridable Function SetAttribute (localName As String, namespaceURI As String, value As String) As String

Parametri

localName
String

Nome locale dell'attributo.The local name of the attribute.

namespaceURI
String

URI dello spazio dei nomi dell'attributo.The namespace URI of the attribute.

value
String

Valore da impostare per l'attributo.The value to set for the attribute.

Restituisce

Valore dell'attributo.The attribute value.

Si applica a