WebServiceAttribute Classe

Riferimento

Definizione

Spazio dei nomi:: System.Web.Services

Assembly:: System.Web.Services.dll

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.

Consente di aggiungere ulteriori informazioni a un servizio Web XML, come una stringa che ne descriva la funzionalità.

public ref class WebServiceAttribute sealed : Attribute

[System.AttributeUsage(System.AttributeTargets.Class)]
public sealed class WebServiceAttribute : Attribute

[System.AttributeUsage(System.AttributeTargets.Class | System.AttributeTargets.Interface)]
public sealed class WebServiceAttribute : Attribute

[<System.AttributeUsage(System.AttributeTargets.Class)>]
type WebServiceAttribute = class
    inherit Attribute

[<System.AttributeUsage(System.AttributeTargets.Class | System.AttributeTargets.Interface)>]
type WebServiceAttribute = class
    inherit Attribute

Public NotInheritable Class WebServiceAttribute
Inherits Attribute

Ereditarietà: Object

Attribute
WebServiceAttribute

Attributi: AttributeUsageAttribute

Esempio

Nell'esempio seguente la Description proprietà di su WebServiceAttribute"Common Server Variables" e imposta lo spazio dei nomi XML su http://www.microsoft.com/.

<%@ WebService Language="C#" Class= "ServerVariables"%>
 
 using System;
 using System.Web.Services;
 
 [ WebService(Description="Common Server Variables",Namespace="http://www.contoso.com/")]
 public class ServerVariables: WebService {
 
 
    [ WebMethod(Description="Obtains the Server Computer Name",EnableSession=false)]
    public string GetMachineName() {
       return Server.MachineName;
    }   
 }

<%@ WebService Language="VB" Class= "ServerVariables"%>
 
Imports System
Imports System.Web.Services

<WebService(Description := "Common Server Variables", _
 Namespace := "http://www.contoso.com/")> _
Public Class ServerVariables
    Inherits WebService 
    
    <WebMethod(Description := "Obtains the Computer Machine Name", _
        EnableSession := False)> _
    Public Function GetMachineName() As String
        
        Return Server.MachineName
    End Function
End Class

Commenti

Non WebServiceAttribute è necessario per la pubblicazione e l'esecuzione di un servizio Web XML. È possibile utilizzare per WebServiceAttribute specificare un nome per il servizio Web XML non limitato dalle regole per un identificatore Common Language Runtime, utilizzato nella descrizione del servizio e nella pagina della Guida del servizio per il servizio Web XML.

Un servizio Web XML deve modificare lo spazio dei nomi XML predefinito prima che venga reso pubblico. Ogni servizio Web XML necessita di uno spazio dei nomi XML univoco per identificarlo in modo che le applicazioni client possano distinguerla da altri servizi sul Web. http://tempuri.org/ è disponibile per i servizi Web XML in fase di sviluppo, ma i servizi Web XML pubblicati devono usare uno spazio dei nomi più permanente.

Il servizio Web XML deve essere identificato da uno spazio dei nomi XML controllato. Ad esempio, è possibile usare il nome di dominio Internet della società come parte dello spazio dei nomi XML. Sebbene molti spazi dei nomi XML del servizio Web siano simili agli URL, non devono puntare a una risorsa effettiva sul Web. Gli spazi dei nomi XML del servizio Web XML sono URI. Per i servizi Web XML creati tramite ASP.NET, è possibile modificare lo spazio dei nomi XML predefinito tramite Namespace la proprietà .

Per altre informazioni sull'uso degli attributi, vedere Attributi.

Costruttori

WebServiceAttribute()

Inizializza una nuova istanza della classe WebServiceAttribute.

Campi

DefaultNamespace

Valore predefinito per la proprietà Namespace. Questo campo è costante.

Proprietà

Description	Messaggio descrittivo per il servizio Web XML.
Name	Ottiene o imposta il nome servizio Web XML.
Namespace	Ottiene o imposta lo spazio dei nomi XML predefinito da utilizzare per il servizio Web XML.
TypeId	Quando è implementata in una classe derivata, ottiene un identificatore univoco della classe Attribute. (Ereditato da Attribute)

Metodi

Equals(Object)	Restituisce un valore che indica se questa istanza è uguale a un oggetto specificato. (Ereditato da Attribute)
GetHashCode()	Restituisce il codice hash per l'istanza. (Ereditato da Attribute)
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
IsDefaultAttribute()	In caso di override in una classe derivata, indica se il valore di questa istanza è il valore predefinito per la classe derivata. (Ereditato da Attribute)
Match(Object)	Quando è sottoposto a override in una classe derivata, restituisce un valore che indica se questa istanza equivale a un oggetto specificato. (Ereditato da Attribute)
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)

Implementazioni dell'interfaccia esplicita

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)	Esegue il mapping di un set di nomi a un set corrispondente di ID dispatch. (Ereditato da Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)	Recupera le informazioni sul tipo relative a un oggetto, che possono essere usate per ottenere informazioni sul tipo relative a un'interfaccia. (Ereditato da Attribute)
_Attribute.GetTypeInfoCount(UInt32)	Recupera il numero delle interfacce di informazioni sul tipo fornite da un oggetto (0 o 1). (Ereditato da Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)	Fornisce l'accesso a proprietà e metodi esposti da un oggetto. (Ereditato da Attribute)

Si applica a

Condividi tramite