XmlAttributeAttribute Klas

Definitie

public ref class XmlAttributeAttribute : Attribute

[System.AttributeUsage(System.AttributeTargets.Field | System.AttributeTargets.Parameter | System.AttributeTargets.Property | System.AttributeTargets.ReturnValue)]
public class XmlAttributeAttribute : Attribute

[<System.AttributeUsage(System.AttributeTargets.Field | System.AttributeTargets.Parameter | System.AttributeTargets.Property | System.AttributeTargets.ReturnValue)>]
type XmlAttributeAttribute = class
    inherit Attribute

Public Class XmlAttributeAttribute
Inherits Attribute

Overname

Object

Attribute

XmlAttributeAttribute

Kenmerken

AttributeUsageAttribute

Voorbeelden

In het volgende voorbeeld wordt een klasse geserialiseerd die verschillende velden bevat waarop de XmlAttributeAttribute klasse wordt toegepast.

using System;
using System.IO;
using System.Xml;
using System.Xml.Serialization;
using System.Xml.Schema;

public class Group
{
   [XmlAttribute (Namespace = "http://www.cpandl.com")]
   public string GroupName;

   [XmlAttribute(DataType = "base64Binary")]
   public Byte [] GroupNumber;

   [XmlAttribute(DataType = "date", AttributeName = "CreationDate")]
   public DateTime Today;
}

public class Run
{
   public static void Main()
   {
      Run test = new Run();
      test.SerializeObject("Attributes.xml");
   }

   public void SerializeObject(string filename)
   {
      // Create an instance of the XmlSerializer class.
      XmlSerializer mySerializer =
      new XmlSerializer(typeof(Group));

      // Writing the file requires a TextWriter.
      TextWriter writer = new StreamWriter(filename);

      // Create an instance of the class that will be serialized.
      Group myGroup = new Group();

      // Set the object properties.
      myGroup.GroupName = ".NET";

      Byte [] hexByte = new Byte[2]{Convert.ToByte(100),
      Convert.ToByte(50)};
      myGroup.GroupNumber = hexByte;

      DateTime myDate = new DateTime(2001,1,10);
      myGroup.Today = myDate;

      // Serialize the class, and close the TextWriter.
      mySerializer.Serialize(writer, myGroup);
       writer.Close();
   }
}

Option Explicit
Option Strict

Imports System.IO
Imports System.Xml
Imports System.Xml.Serialization
Imports System.Xml.Schema


Public Class Group
    <XmlAttribute(Namespace := "http://www.cpandl.com")> _
        Public GroupName As String    
    <XmlAttribute(DataType := "base64Binary")> _
        Public GroupNumber() As Byte    
    <XmlAttribute(DataType := "date", AttributeName := "CreationDate")> _
        Public Today As DateTime
End Class

Public Class Run
    
    Public Shared Sub Main()
        Dim test As New Run()
        test.SerializeObject("Attributes.xml")
    End Sub 
    
    Public Sub SerializeObject(ByVal filename As String)
        ' Create an instance of the XmlSerializer class.
        Dim mySerializer As New XmlSerializer(GetType(Group))
        
        ' Writing the file requires a TextWriter.
        Dim writer As New StreamWriter(filename)
        
        ' Create an instance of the class that will be serialized.
        Dim myGroup As New Group()
        
        ' Set the object properties.
        myGroup.GroupName = ".NET"
        
        Dim hexByte() As Byte = {Convert.ToByte(100), Convert.ToByte(50)}
        myGroup.GroupNumber = hexByte
        
        Dim myDate As New DateTime(2001, 1, 10)
        myGroup.Today = myDate
        
        ' Serialize the class, and close the TextWriter.
        mySerializer.Serialize(writer, myGroup)
        writer.Close()
    End Sub
End Class

Opmerkingen

Het XmlAttributeAttribute behoort tot een familie van kenmerken die bepalen hoe de XmlSerializer serialiseren, of deserialisaties, een object. Zie Kenmerken die XML-serialisatie regelen voor een volledige lijst met vergelijkbare kenmerken.

Wanneer deze wordt toegepast op een openbaar veld of een openbare eigenschap, XmlAttributeAttribute wordt het XmlSerializer lid geïnformeerd om het lid te serialiseren als een XML-kenmerk. XmlSerializer Standaard worden openbare velden en eigenschappen geserialiseerd als XML-elementen.

U kunt de XmlAttributeAttribute enige toewijzen aan openbare velden of openbare eigenschappen die een waarde (of matrix met waarden) retourneren die kunnen worden toegewezen aan een van de eenvoudige XSD-typen (XML Schema Definition Language), inclusief alle ingebouwde gegevenstypen die zijn afgeleid van het XSD-type anySimpleType . De mogelijke typen omvatten alle typen die kunnen worden toegewezen aan de eenvoudige XSD-typen, waaronder Guid, Charen opsommingen. Zie de eigenschap DataType voor een lijst met XSD-typen en hoe deze worden toegewezen.NET gegevenstypen.

Er zijn twee speciale kenmerken die kunnen worden ingesteld met de XmlAttributeAttribute kenmerken : de xml:lang (specificeert taal) en xml:space (geeft aan hoe witruimte moet worden verwerkt) kenmerken. Deze kenmerken zijn bedoeld om informatie over te brengen die alleen relevant is voor een toepassing die de XML verwerkt. Voorbeelden van het instellen hiervan worden weergegeven in de volgende code.

[XmlAttribute("xml:lang")]
 public string Lang;
 // Set this to 'default' or 'preserve'.
 [XmlAttribute("space",
 Namespace = "http://www.w3.org/XML/1998/namespace")]
 public string Space

<XmlAttribute("xml:lang")> _
Public Lang As String
' Set this to 'default' or 'preserve'.
<XmlAttribute("space", _
Namespace:= "http://www.w3.org/XML/1998/namespace")> _
Public Space As String

Zie Kenmerken voor meer informatie over het gebruik van kenmerken.