WebServiceAttribute.Namespace Vlastnost
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Získá nebo nastaví výchozí obor názvů XML použít pro xml webové služby.
public:
property System::String ^ Namespace { System::String ^ get(); void set(System::String ^ value); };
public string Namespace { get; set; }
member this.Namespace : string with get, set
Public Property Namespace As String
Hodnota vlastnosti
Výchozí obor názvů XML, který se má použít pro webovou službu XML. Výchozí hodnota je zadána DefaultNamespace ve vlastnosti .
Příklady
Následující příklad nastaví Namespace a http://www.contoso.com
přepíše tento obor názvů pro Action vlastnost přidáním do SoapDocumentMethodAttributeTime
metody webové služby XML.
<%@ WebService Language="C#" class= "ServerVariables"%>
using System;
using System.Web.Services;
using System.Web.Services.Protocols;
[ WebService(Description="Server Variables",
Namespace="http://www.contoso.com/")]
public class ServerVariables: WebService {
[ SoapDocumentMethod(Action="http://www.contoso.com/Time")]
[ 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
Imports System.Web.Services
Imports System.Web.Services.Protocols
<WebService(Description := "Server Variables", _
Namespace := "http://www.contoso.com/")> _
Public Class ServerVariables
Inherits WebService
<SoapDocumentMethod(Action := "http://www.contoso.com/Time"), _
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
Poznámky
Obory názvů XML nabízejí způsob, jak vytvořit názvy v dokumentu XML, které jsou identifikovány identifikátorem URI (Uniform Resource Identifier). Pomocí oborů názvů XML můžete jedinečně identifikovat prvky nebo atributy v dokumentu XML. Popis služby pro webovou službu XML je definován v jazyce XML, konkrétně v jazyce WSDL (Web Services Description Language).
V rámci popis služby pro webovou službu XML se Namespace používá jako výchozí obor názvů pro elementy XML, které se přímo vztahují k webové službě XML. Například název webové služby XML a jejích metod webové služby XML se vztahuje k oboru názvů zadané ve Namespace
vlastnosti. Prvky, které jsou specifické pro WSDL, se vztahují k http://schemas.xmlsoap.org/wsdl/ oboru názvů.
U klientů webové služby XML používajících protokol SOAP k volání webové služby XML můžete volitelně přidat metodu SoapDocumentMethodAttribute nebo SoapRpcMethodAttribute pro volání webové služby XML. Pokud klient volá webovou službu XML vytvořenou pomocí ASP.NET, RequestNamespacejsou všechny vlastnosti a ResponseNamespaceAction odvozeny od Namespace vlastnosti ve výchozím nastavení. Například vzhledem k názvu Time
metody webové služby XML a Namespace
vlastnosti http://www.contoso.com/
je Action
vlastnost http://www.contoso.com/Time
ve výchozím nastavení. Chcete-li změnit výchozí nastavení pro RequestNamespace
, ResponseNamespace
a Action
pro metodu webové služby XML, můžete přidat SoapDocumentMethodAttribute do metody webové služby XML.
Poznámka
Obor názvů XML se liší od oboru názvů, ve kterém se třída nachází, pokud jde o sadu Windows SDK. Pokud chcete zadat obor názvů pro třídu, přečtěte si téma Klíčová slova oboru názvů , pokud píšete v jazyce C#.