Condividi tramite


ServiceKnownTypeAttribute Costruttori

Definizione

Inizializza una nuova istanza della classe ServiceKnownTypeAttribute.

Overload

ServiceKnownTypeAttribute(String)

Inizializza una nuova istanza della classe ServiceKnownTypeAttribute e specifica il nome di un metodo che restituisce i tipi conosciuti.

ServiceKnownTypeAttribute(Type)

Consente di inizializzare una nuova istanza della classe ServiceKnownTypeAttribute con il tipo conosciuto specificato.

ServiceKnownTypeAttribute(String, Type)

Consente di inizializzare una nuova istanza della classe ServiceKnownTypeAttribute con il nome di un metodo e con il tipo contenente i metodi che restituiscono i tipi conosciuti.

ServiceKnownTypeAttribute(String)

Inizializza una nuova istanza della classe ServiceKnownTypeAttribute e specifica il nome di un metodo che restituisce i tipi conosciuti.

public:
 ServiceKnownTypeAttribute(System::String ^ methodName);
public ServiceKnownTypeAttribute (string methodName);
new System.ServiceModel.ServiceKnownTypeAttribute : string -> System.ServiceModel.ServiceKnownTypeAttribute
Public Sub New (methodName As String)

Parametri

methodName
String

Nome di un metodo che restituisce i tipi conosciuti.

Commenti

Usare questo costruttore quando si applica l'oggetto ServiceKnownTypeAttribute a una classe che contiene metodi che restituiscono tipi noti.

Vedi anche

Si applica a

ServiceKnownTypeAttribute(Type)

Consente di inizializzare una nuova istanza della classe ServiceKnownTypeAttribute con il tipo conosciuto specificato.

public:
 ServiceKnownTypeAttribute(Type ^ type);
public ServiceKnownTypeAttribute (Type type);
new System.ServiceModel.ServiceKnownTypeAttribute : Type -> System.ServiceModel.ServiceKnownTypeAttribute
Public Sub New (type As Type)

Parametri

type
Type

Consente di specificare un tipo conosciuto utilizzabile in un parametro o in un valore restituito definito dal servizio.

Esempio

Nell'esempio seguente viene applicato l'attributo a un'interfaccia in cui l'attributo ServiceKnownTypeAttribute specifica il tipo da includere.

// Apply the ServiceKnownTypeAttribute to the
// interface specifying the type to include. Apply
// the attribute more than once if needed.
[ServiceKnownType(typeof(Widget))]
[ServiceKnownType(typeof(Machine))]
[ServiceContract()]
public interface ICatalog2
{
    // Any object type can be inserted into a Hashtable. The
    // ServiceKnownTypeAttribute allows you to include those types
    // with the client code.
    [OperationContract]
    Hashtable GetItems();
}
' Apply the ServiceKnownTypeAttribute to the 
' interface specifying the type to include. Apply the attribute
' more than once, if needed.
<ServiceKnownType(GetType(Widget)), ServiceKnownType(GetType(Machine)), _
 ServiceContract()>  _
Public Interface ICalculator2
    ' Any object type can be inserted into a Hashtable. The 
    ' ServiceKnownTypeAttribute allows you to include those types
    ' with the client code.
    <OperationContract()>  _
    Function GetItems() As Hashtable 
End Interface

Commenti

L'oggetto ServiceKnownTypeAttribute può essere applicato più volte a un metodo, con ogni applicazione che rinomina un tipo noto diverso che può essere presente nel grafico dell'oggetto restituito dal metodo.

Si applica a

ServiceKnownTypeAttribute(String, Type)

Consente di inizializzare una nuova istanza della classe ServiceKnownTypeAttribute con il nome di un metodo e con il tipo contenente i metodi che restituiscono i tipi conosciuti.

public:
 ServiceKnownTypeAttribute(System::String ^ methodName, Type ^ declaringType);
public ServiceKnownTypeAttribute (string methodName, Type declaringType);
new System.ServiceModel.ServiceKnownTypeAttribute : string * Type -> System.ServiceModel.ServiceKnownTypeAttribute
Public Sub New (methodName As String, declaringType As Type)

Parametri

methodName
String

Nome di un metodo che restituisce i tipi conosciuti.

declaringType
Type

Tipo che può utilizzare i tipi conosciuti nel proprio oggetto grafico.

Esempio

Nell'esempio seguente viene applicato l'attributo a un'interfaccia in cui l'attributo ServiceKnownTypeAttribute specifica un nome del metodo e un tipo dichiarante.

// Define a service contract and apply the ServiceKnownTypeAttribute
// to specify types to include when generating client code.
// The types must have the DataContractAttribute and DataMemberAttribute
// applied to be serialized and deserialized. The attribute specifies the
// name of a method (GetKnownTypes) in a class (Helper) defined below.
[ServiceKnownType("GetKnownTypes", typeof(Helper))]
[ServiceContract()]
public interface ICatalog
{
    // Any object type can be inserted into a Hashtable. The
    // ServiceKnownTypeAttribute allows you to include those types
    // with the client code.
    [OperationContract]
    Hashtable GetItems();
}

// This class has the method named GetKnownTypes that returns a generic IEnumerable.
static class Helper
{
    public static IEnumerable<Type> GetKnownTypes(ICustomAttributeProvider provider)
    {
        System.Collections.Generic.List<System.Type> knownTypes =
            new System.Collections.Generic.List<System.Type>();
        // Add any types to include here.
        knownTypes.Add(typeof(Widget));
        knownTypes.Add(typeof(Machine));
        return knownTypes;
    }
}

[DataContract()]
public class Widget
{
    [DataMember]
    public string Id;
    [DataMember]
    public string Catalog;
}

[DataContract()]
public class Machine : Widget
{
    [DataMember]
    public string Maker;
}
' Define a service contract and apply the ServiceKnownTypeAttribute
' to specify types to include when generating client code. 
' The types must have the DataContractAttribute and DataMemberAttribute
' applied to be serialized and deserialized. The attribute specifies the 
' name of a method (GetKnownTypes) in a class (Helper) defined below.
<ServiceKnownType("GetKnownTypes", GetType(Helper)), ServiceContract()>  _
Public Interface ICalculator
    ' Any object type can be inserted into a Hashtable. The 
    ' ServiceKnownTypeAttribute allows you to include those types
    ' with the client code.
    <OperationContract()>  _
    Function GetItems() As Hashtable 
End Interface 

' This class has the method named GetKnownTypes that returns a generic IEnumerable.
Friend Class Helper
    Public Shared  Function GetKnownTypes(provider As ICustomAttributeProvider) _
     As IEnumerable(of Type) 
        Dim knownTypes As List(Of Type) = New List(Of Type)
        ' Add any types to include here.
        knownTypes.Add(GetType(Widget))
        knownTypes.Add(GetType(Machine))
        Return knownTypes
    End Function 
End Class 

<DataContract()>  _
Public Class Widget
    <DataMember()>  _
    Public Id As String
    <DataMember()>  _
    Public Catalog As String
End Class 

<DataContract()>  _
Public Class Machine
    Inherits Widget
    <DataMember()>  _
    Public Maker As String
End Class

Vedi anche

Si applica a