Sdílet prostřednictvím

WebServiceAttribute Třída

Definice

Obor názvů:
System.Web.Services
Sestavení:
System.Web.Services.dll

Slouží k přidání dalších informací do webové služby XML, například řetězec popisující jeho funkce.

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
Dědičnost
Object
Attribute
WebServiceAttribute
Atributy
AttributeUsageAttribute

Příklady

Následující příklad nastaví Description vlastnost WebServiceAttribute na "Common Server Variables" a nastaví obor názvů XML na 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

Poznámky

Není WebServiceAttribute vyžadováno, aby webová služba XML byla publikována a spuštěna. Můžete použít WebServiceAttribute k zadání názvu webové služby XML, která není omezena pravidly pro identifikátor modulu CLR (Common Language Runtime), který se používá v popisu služby a na stránce nápovědy služby pro webovou službu XML.

Webová služba XML by měla před zveřejněním změnit výchozí obor názvů XML. Každá webová služba XML potřebuje jedinečný obor názvů XML k identifikaci, aby je klientské aplikace mohly odlišit od ostatních služeb na webu. http://tempuri.org/ je k dispozici pro webové služby XML, které jsou ve vývoji, ale publikované webové služby XML by měly používat trvalejší obor názvů.

Webová služba XML by měla být identifikována oborem názvů XML, který řídíte. Jako součást oboru názvů XML můžete například použít název internetové domény vaší společnosti. Přestože mnoho oborů názvů XML webové služby XML vypadá jako adresy URL, nemusí odkazovat na skutečný prostředek na webu. (Obory názvů XML webové služby XML jsou identifikátory URI.) U webových služeb XML vytvořených pomocí ASP.NET lze výchozí obor názvů XML změnit pomocí Namespace vlastnosti.

Další informace o používání atributů naleznete v tématu Atributy.

Konstruktory

Name Description
WebServiceAttribute()

Inicializuje novou instanci WebServiceAttribute třídy.

Pole

Name Description
DefaultNamespace

Výchozí hodnota vlastnosti Namespace . Toto pole je konstantní.

Vlastnosti

Name Description
Description

Popisná zpráva pro webovou službu XML.
Name

Získá nebo nastaví název webové služby XML.
Namespace

Získá nebo nastaví výchozí obor názvů XML použít pro webovou službu XML.
TypeId

Při implementaci v odvozené třídě získá jedinečný identifikátor pro tento Attribute.

(Zděděno od Attribute)

Metody

Name Description
Equals(Object)

Vrátí hodnotu, která určuje, zda je tato instance rovna zadanému objektu.

(Zděděno od Attribute)
GetHashCode()

Vrátí kód hash pro tuto instanci.

(Zděděno od Attribute)
GetType()

Získá Type aktuální instance.

(Zděděno od Object)
IsDefaultAttribute()

Při přepsání v odvozené třídě určuje, zda hodnota této instance je výchozí hodnotou pro odvozenou třídu.

(Zděděno od Attribute)
Match(Object)

Při přepsání v odvozené třídě vrátí hodnotu, která určuje, zda se tato instance rovná zadanému objektu.

(Zděděno od Attribute)
MemberwiseClone()

Vytvoří mělkou kopii aktuálního Object.

(Zděděno od Object)
ToString()

Vrátí řetězec, který představuje aktuální objekt.

(Zděděno od Object)

Explicitní implementace rozhraní

Name Description
_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)

Mapuje sadu názvů na odpovídající sadu identifikátorů pro rozesílání.

(Zděděno od Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

Načte informace o typu objektu, který lze použít k získání informací o typu pro rozhraní.

(Zděděno od Attribute)
_Attribute.GetTypeInfoCount(UInt32)

Získá počet rozhraní typu informací, které objekt poskytuje (0 nebo 1).

(Zděděno od Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

Poskytuje přístup k vlastnostem a metodám vystaveným objektem.

(Zděděno od Attribute)

Platí pro

Viz také