XmlArrayAttribute.ElementName Proprietà
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Recupera o imposta il nome dell'elemento XML associato alla matrice serializzata.
public:
property System::String ^ ElementName { System::String ^ get(); void set(System::String ^ value); };
public string ElementName { get; set; }
member this.ElementName : string with get, set
Public Property ElementName As String
Il nome dell'elemento XML della matrice serializzata. Il valore predefinito è il nome del membro al quale è assegnato XmlArrayAttribute.
Nell'esempio seguente viene serializzato un'istanza della Library
classe contenente una proprietà denominata Books
che restituisce una matrice di Book
elementi. Nell'esempio viene utilizzata la ElementName proprietà per specificare che la matrice di elementi XML deve essere denominata My_Books
anziché Books
.
#using <System.Xml.dll>
#using <System.dll>
using namespace System;
using namespace System::IO;
using namespace System::Xml;
using namespace System::Xml::Serialization;
public ref class Book
{
public:
String^ Title;
String^ Author;
String^ ISBN;
};
public ref class Library
{
private:
array<Book^>^books;
public:
[XmlArray(ElementName="My_Books")]
property array<Book^>^ Books
{
array<Book^>^ get()
{
return books;
}
void set( array<Book^>^value )
{
books = value;
}
}
};
int main()
{
String^ filename = "ArrayExample.xml";
XmlSerializer^ mySerializer = gcnew XmlSerializer( Library::typeid );
TextWriter^ t = gcnew StreamWriter( filename );
XmlSerializerNamespaces^ ns = gcnew XmlSerializerNamespaces;
ns->Add( "bk", "http://wwww.contoso.com" );
Book^ b1 = gcnew Book;
b1->Title = "MyBook Title";
b1->Author = "An Author";
b1->ISBN = "00000000";
Book^ b2 = gcnew Book;
b2->Title = "Another Title";
b2->Author = "Another Author";
b2->ISBN = "0000000";
Library^ myLibrary = gcnew Library;
array<Book^>^myBooks = {b1,b2};
myLibrary->Books = myBooks;
mySerializer->Serialize( t, myLibrary, ns );
t->Close();
}
using System;
using System.IO;
using System.Xml;
using System.Xml.Serialization;
public class Library
{
private Book[] books;
[XmlArray(ElementName="My_Books")]
public Book[] Books
{
get{return books;}
set{books = value;}
}
}
public class Book
{
public string Title;
public string Author;
public string ISBN;
}
public class Run
{
public static void Main()
{
Run test = new Run();
test.WriteBook("ArrayExample.xml");
}
public void WriteBook(string filename)
{
XmlSerializer mySerializer = new XmlSerializer(typeof(Library));
TextWriter t = new StreamWriter(filename);
XmlSerializerNamespaces ns = new XmlSerializerNamespaces();
ns.Add("bk", "http://wwww.contoso.com");
Book b1 = new Book();
b1.Title = "MyBook Title";
b1.Author = "An Author";
b1.ISBN = "00000000";
Book b2 = new Book();
b2.Title = "Another Title";
b2.Author = "Another Author";
b2.ISBN = "0000000";
Library myLibrary = new Library();
Book[] myBooks = {b1,b2};
myLibrary.Books = myBooks;
mySerializer.Serialize(t,myLibrary,ns);
t.Close();
}
}
Option Explicit
Option Strict
Imports System.IO
Imports System.Xml
Imports System.Xml.Serialization
Public Class Library
Private myBooks() As Book
<XmlArray(ElementName := "My_Books")> _
Public Property Books() As Book()
Get
Return myBooks
End Get
Set
myBooks = value
End Set
End Property
End Class
Public Class Book
Public Title As String
Public Author As String
Public ISBN As String
End Class
Public Class Run
Public Shared Sub Main()
Dim test As New Run()
test.WriteBook("ArrayExample.xml")
End Sub
Public Sub WriteBook(ByVal filename As String)
Dim mySerializer As New XmlSerializer(GetType(Library))
Dim t As New StreamWriter(filename)
Dim ns As New XmlSerializerNamespaces()
ns.Add("bk", "http://wwww.contoso.com")
Dim b1 As New Book()
b1.Title = "MyBook Title"
b1.Author = "An Author"
b1.ISBN = "00000000"
Dim b2 As New Book()
b2.Title = "Another Title"
b2.Author = "Another Author"
b2.ISBN = "0000000"
Dim myLibrary As New Library()
Dim myBooks() As Book = {b1, b2}
myLibrary.Books = myBooks
mySerializer.Serialize(t, myLibrary, ns)
t.Close()
End Sub
End Class
Specificare un ElementName oggetto quando si vuole che il nome dell'elemento XML generato sia diverso dall'identificatore del membro.
È possibile impostare lo stesso ElementName valore su più membri purché il documento XML generato usi spazi dei nomi XML per distinguere tra i membri denominati in modo identico. Per altre informazioni sull'uso di spazi dei nomi e sulla creazione di nomi con prefisso nel documento XML, vedere XmlSerializerNamespaces.