WebServiceAttribute.Name Proprietà

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.

Ottiene o imposta il nome servizio Web XML.

public:
 property System::String ^ Name { System::String ^ get(); void set(System::String ^ value); };

public string Name { get; set; }

member this.Name : string with get, set

Public Property Name As String

Valore della proprietà

String

Nome del servizio Web XML. Il valore predefinito è il nome della classe che implementa il servizio Web XML.

Esempio

Nell'esempio seguente il servizio Web XML viene impostato Name su MyName.

<%@ WebService Language="C#" class= "ServerVariables"%>
 
 using System.Web.Services;
 
 [ WebService(Description="Server Variables",
              Namespace="http://www.microsoft.com/",
              Name="MyName")]
 public class ServerVariables: WebService {
    [ WebMethod(Description="Returns the time as stored on the Server",
    EnableSession=false)]
    public string Time() {
       return Context.Timestamp.TimeOfDay.ToString();
    }
 }

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

<WebService(Description := "Server Variables", _
    Namespace := "http://www.microsoft.com/", _
    Name := "MyName")> _
Public Class ServerVariables
    Inherits WebService
    
    <WebMethod(Description := "Returns the time as stored on the Server", _
        EnableSession := False)> _
    Public Function Time() As String
        
        Return Context.Timestamp.TimeOfDay.ToString()
    End Function
End Class

Commenti

La descrizione del servizio viene generata quando un utente passa all'URL per il servizio Web XML e fornisce una stringa di query di ? WSDL. All'interno della descrizione del servizio, la Name proprietà identifica la parte locale del nome completo XML per il servizio Web XML. La Name proprietà viene utilizzata anche per visualizzare il nome del servizio Web XML nella pagina della Guida del servizio. La pagina della Guida del servizio viene visualizzata quando un potenziale consumer passa alla pagina asmx per il servizio Web XML senza specificare un nome di metodo del servizio Web XML e i relativi parametri.

Un nome completo XML viene usato per disambiguare gli elementi con lo stesso nome con un documento XML. Un nome completo XML è costituito dalle due parti seguenti separate da due punti: spazio dei nomi o prefisso associato a uno spazio dei nomi e a una parte locale. Lo spazio dei nomi è costituito da un riferimento URI e ai fini della descrizione del servizio è il valore della Namespace proprietà . In generale, un prefisso, che agisce come un alias a un URI, è associato allo spazio dei nomi, in modo che tutti i nomi xml successivi qualificati usando lo spazio dei nomi possano usare il prefisso abbreviato. La parte locale è una stringa che inizia con una lettera o un carattere di sottolineatura senza spazi. Di conseguenza, il nome completo XML che identifica un servizio Web XML nella descrizione del servizio è nel formato seguente:

Namespace : Name

Per altre informazioni sui nomi completi XML, vedere Spazi dei nomi in XML 1.0.

Si applica a

Vedi anche

Namespace