UrlAttribute Osztály

Definíció

Névtér:

System.Runtime.Remoting.Activation

Szerelvény:

mscorlib.dll

Definiál egy attribútumot, amely a hívási helyen használható annak az URL-címnek a megadásához, ahol az aktiválás történni fog. Ez az osztály nem örökölhető.

public ref class UrlAttribute sealed : System::Runtime::Remoting::Contexts::ContextAttribute

[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
[System.Security.SecurityCritical]
public sealed class UrlAttribute : System.Runtime.Remoting.Contexts.ContextAttribute

[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
[<System.Security.SecurityCritical>]
type UrlAttribute = class
    inherit ContextAttribute

Public NotInheritable Class UrlAttribute
Inherits ContextAttribute

Öröklődés

Object

Attribute

ContextAttribute

UrlAttribute

Attribútumok

SerializableAttribute ComVisibleAttribute SecurityCriticalAttribute

Példák

Az alábbi kód példája az ügyfél által aktivált újraküldés beállításának UrlAttribute használatát mutatja be. A példa három részből áll: egy ügyfélből, egy kiszolgálóból és egy távoli objektumból, amelyet az ügyfél és a kiszolgáló használ.

Az alábbi példakód egy ügyfelet mutat be:

#using <System.Runtime.Remoting.dll>
#using <System.dll>
#using "RemoteObject.dll"

using namespace System;
using namespace System::Runtime::Remoting;
using namespace System::Runtime::Remoting::Activation;
using namespace System::Runtime::Remoting::Channels;
using namespace System::Runtime::Remoting::Channels::Tcp;

[STAThread]
int main()
{
   
   // Report initial status.
   Console::WriteLine( "Client starting." );
   
   // Register TCP channel.
   ChannelServices::RegisterChannel( gcnew TcpChannel );
   
   // Create UrlAttribute.
   UrlAttribute^ attribute = gcnew UrlAttribute( "tcp://localhost:1234/RemoteApp" );
   Console::WriteLine( "UrlAttribute value: {0}", attribute->UrlValue );
   
   array<Object^>^activationAttributes = {attribute};
   
   // Use UrlAttribute to register for client activated remote object.
   RemotingConfiguration::RegisterActivatedClientType( RemoteObject::typeid, "tcp://localhost:1234/RemoteApp" );
   
   // Activate remote object.
   Console::WriteLine( "Activating remote object." );
   RemoteObject ^ obj = dynamic_cast<RemoteObject^>(Activator::CreateInstance( RemoteObject::typeid, nullptr, activationAttributes ));
   
   // Invoke a method on it.
   Console::WriteLine( "Invoking Hello() on remote object." );
   obj->Hello();
   
   // Inform user of termination.
   Console::WriteLine( "Terminating client." );
}

using System;
using System.Runtime.Remoting;
using System.Runtime.Remoting.Activation;
using System.Runtime.Remoting.Channels;
using System.Runtime.Remoting.Channels.Tcp;

public class Client
{
    [STAThread]
    public static void Main()
    {
        // Report the initial status.
        Console.WriteLine("Starting client.");

        // Register the TCP channel.
        ChannelServices.RegisterChannel(new TcpChannel());

        // Create a url attribute object.
        UrlAttribute attribute =
            new UrlAttribute("tcp://localhost:1234/RemoteApp");
        Console.WriteLine("UrlAttribute value: {0}", attribute.UrlValue);
        object[] activationAttributes = new object[] { attribute };

        // Register the client for the remote object.
        RemotingConfiguration.RegisterActivatedClientType(
            typeof(RemoteObject),
            "tcp://localhost:1234/RemoteApp");

        // Activate the remote object.
        Console.WriteLine("Activating remote object.");
        RemoteObject obj = (RemoteObject) Activator.CreateInstance(
            typeof(RemoteObject), null, activationAttributes);

        // Invoke a method on the remote object.
        Console.WriteLine("Invoking Hello() on remote object.");
        obj.Hello();

        // Inform the user that the program is exiting.
        Console.WriteLine("The client is exiting.");
    }
}

Az alábbi példakód az ügyfél kiszolgálóját mutatja be:

#using <System.Runtime.Remoting.dll>
#using <System.dll>
#using "RemoteObject.dll"

using namespace System;
using namespace System::Runtime::Remoting;
using namespace System::Runtime::Remoting::Channels;
using namespace System::Runtime::Remoting::Channels::Tcp;

[STAThread]
int main()
{
   
   // Report status to user.
   Console::WriteLine( "Server starting." );
   
   // Register the TCP channel.
   ChannelServices::RegisterChannel( gcnew TcpChannel( 1234 ) );
   
   // Set application name.
   RemotingConfiguration::ApplicationName = "RemoteApp";
   
   // Register object for client activated remoting.
   RemotingConfiguration::RegisterActivatedServiceType( RemoteObject::typeid );
   
   // Wait until termination.
   Console::WriteLine( "Press enter to end." );
   Console::ReadLine();
   Console::WriteLine( "Terminating server." );
}

using System;
using System.Runtime.Remoting;
using System.Runtime.Remoting.Channels;
using System.Runtime.Remoting.Channels.Tcp;

public class Server
{
    [STAThread]
    public static void Main()
    {
        // Report the status to the user.
        Console.WriteLine("Starting server.");

        // Register the TCP channel.
        ChannelServices.RegisterChannel(new TcpChannel(1234));

        // Set the application name.
        RemotingConfiguration.ApplicationName = "RemoteApp";

        // Register the object for remoting.
        RemotingConfiguration.RegisterActivatedServiceType(
            typeof(RemoteObject));

        // Wait until the user presses ENTER.
        Console.WriteLine("Press ENTER to exit.");
        Console.ReadLine();
        Console.WriteLine("The server is exiting.");
    }
}

Az alábbi példakód az ügyfél és a kiszolgáló által használt távoli objektumot mutatja be:

using namespace System;
using namespace System::Security;
using namespace System::Security::Permissions;

[assembly:AllowPartiallyTrustedCallersAttribute];
public ref class RemoteObject: public MarshalByRefObject
{
public:
   RemoteObject()
   {
      
      // Report object construction to server's console.
      Console::WriteLine( "You have called the constructor." );
   }

   void Hello()
   {
      
      // Report method invocation to server's console.
      Console::WriteLine( "You have called Hello()." );
   }

};

using System;
using System.Security;
using System.Security.Permissions;

public class RemoteObject : MarshalByRefObject
{
    public RemoteObject()
    {
        Console.WriteLine("You have called the constructor.");
    }

    public void Hello()
    {
        Console.WriteLine("You have called Hello().");
    }
}

Megjegyzések

A UrlAttribute rendszer paraméterként Activator.CreateInstance adja át az aktiválási attribútumok tömbjében, amikor aktivált objektumokat hoz létre a CreateInstance metódussal.

Az attribútumok használatáról további információt az Attribútumok című témakörben talál.

Konstruktorok

Name	Description
UrlAttribute(String)	Létrehozza az osztály új példányát UrlAttribute .

Mezők

Name	Description
AttributeName	Ez az API a termékinfrastruktúrát támogatja, és közvetlenül a kódból nem használható. A környezeti attribútum nevét jelzi. (Öröklődés forrása ContextAttribute)

Tulajdonságok

Name	Description
Name	Ez az API a termékinfrastruktúrát támogatja, és közvetlenül a kódból nem használható. Lekéri a környezeti attribútum nevét. (Öröklődés forrása ContextAttribute)
TypeId	Ha származtatott osztályban implementálják, ehhez egy egyedi azonosítót Attributekap. (Öröklődés forrása Attribute)
UrlValue	Lekéri a UrlAttribute.

Metódusok

Name	Description
Equals(Object)	Ellenőrzi, hogy a megadott objektum ugyanarra az URL-címre hivatkozik-e, mint az aktuális példány.
Freeze(Context)	Ez az API a termékinfrastruktúrát támogatja, és közvetlenül a kódból nem használható. Akkor hívjuk meg, ha a környezet le van fagyasztva. (Öröklődés forrása ContextAttribute)
GetHashCode()	Az aktuális UrlAttributekivonat értékét adja vissza.
GetPropertiesForNewContext(IConstructionCallMessage)	Kényszeríti a környezet és a kiszolgálóobjektum létrehozását a környezeten belül a megadott URL-címen.
GetType()	Lekéri az Type aktuális példányt. (Öröklődés forrása Object)
IsContextOK(Context, IConstructionCallMessage)	Logikai értéket ad vissza, amely jelzi, hogy a megadott Context megfelel-e UrlAttributea követelményeknek.
IsDefaultAttribute()	Ha egy származtatott osztályban felül van bírálva, azt jelzi, hogy a példány értéke-e a származtatott osztály alapértelmezett értéke. (Öröklődés forrása Attribute)
IsNewContextOK(Context)	Ez az API a termékinfrastruktúrát támogatja, és közvetlenül a kódból nem használható. Logikai értéket ad vissza, amely jelzi, hogy a környezeti tulajdonság kompatibilis-e az új környezettel. (Öröklődés forrása ContextAttribute)
Match(Object)	Származtatott osztály felülírásakor egy olyan értéket ad vissza, amely jelzi, hogy ez a példány egy adott objektummal egyenlő-e. (Öröklődés forrása Attribute)
MemberwiseClone()	Az aktuális Objectpéldány sekély másolatát hozza létre. (Öröklődés forrása Object)
ToString()	Az aktuális objektumot jelképező sztringet ad vissza. (Öröklődés forrása Object)

Explicit interfész-implementációk

Name	Description
_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)	Névkészletet képez le a küldési azonosítók megfelelő készletére. (Öröklődés forrása Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)	Lekéri egy objektum típusadatait, amelyek a felület típusadatainak lekérésére használhatók. (Öröklődés forrása Attribute)
_Attribute.GetTypeInfoCount(UInt32)	Lekéri az objektumok által biztosított típusinformációs felületek számát (0 vagy 1). (Öröklődés forrása Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)	Hozzáférést biztosít az objektumok által közzétett tulajdonságokhoz és metódusokhoz. (Öröklődés forrása Attribute)

Lásd még

• ContextAttribute
• IContextProperty