RemotingServices.SetObjectUriForMarshal(MarshalByRefObject, String) Método

Definição

Espaço de Nomes:
System.Runtime.Remoting
Assemblagem:
mscorlib.dll

Define o URI para a chamada subsequente ao Marshal(MarshalByRefObject) método.

public:
 static void SetObjectUriForMarshal(MarshalByRefObject ^ obj, System::String ^ uri);
public static void SetObjectUriForMarshal(MarshalByRefObject obj, string uri);
static member SetObjectUriForMarshal : MarshalByRefObject * string -> unit
Public Shared Sub SetObjectUriForMarshal (obj As MarshalByRefObject, uri As String)

Parâmetros

obj
MarshalByRefObject

O objeto para definir um URI.

uri
String

O URI a atribuir ao objeto especificado.

Exceções

RemotingException

obj não é um objeto local, já foi marshaled, ou o método atual já foi chamado.

SecurityException

Pelo menos um dos chamadores mais acima na pilha de chamadas não tem permissão para configurar tipos e canais de remoto.

Exemplos

O exemplo de código seguinte demonstra como definir o URI que será usado pelo Marshal método ao fazer o marshal do objeto especificado.

using namespace System;
using namespace System::Runtime::Remoting;
using namespace System::Security::Permissions;

public ref class SetObjectUriForMarshalTest
{
public:
   ref class TestClass: public MarshalByRefObject{};

   [SecurityPermissionAttribute(SecurityAction::Demand, Flags=SecurityPermissionFlag::RemotingConfiguration)]   
   static void Main()
   {
      TestClass^ obj = gcnew TestClass;
      RemotingServices::SetObjectUriForMarshal( obj,  "testUri" );
      RemotingServices::Marshal(obj);
      Console::WriteLine( RemotingServices::GetObjectUri( obj ) );
   }

};

using System;
using System.Runtime.Remoting;

public class SetObjectUriForMarshalTest  {

    class TestClass : MarshalByRefObject {
    }

    public static void Main()  {

        TestClass obj = new TestClass();

        RemotingServices.SetObjectUriForMarshal(obj, "testUri");
        RemotingServices.Marshal(obj);

        Console.WriteLine(RemotingServices.GetObjectUri(obj));
    }
}

Imports System.Runtime.Remoting
Imports System.Security.Permissions


Public Class SetObjectUriForMarshalTest
    
    Class TestClass
        Inherits MarshalByRefObject
    End Class

    <SecurityPermission(SecurityAction.Demand, Flags:= SecurityPermissionFlag.RemotingConfiguration )> _
    Public Shared Sub Main()
        Dim obj As TestClass = New TestClass()

        RemotingServices.SetObjectUriForMarshal(obj, "testUri")
        RemotingServices.Marshal(obj)

        Console.WriteLine(RemotingServices.GetObjectUri(obj))
    End Sub

End Class

Observações

O URI definido pelo método atual é usado ao fazer o marshal do objeto dado.

Após o marshaling, o URI do objeto especificado é definido para a string no uri parâmetro adicionado ao Guid do atual AppDomain.

Se a aplicação atual estiver a ouvir numa porta HTTP, então tanto a cadeia especificada no uri parâmetro como a uri cadeia adicionada à Guid rota atual AppDomain para o objeto especificado. Por exemplo, se a aplicação estiver a ouvir na porta HTTP 9000, então tanto http://localhost:9000/objectUri, como http://localhost:9000/<appdomainguid>/objectUri a rota para o objeto especificado no obj parâmetro.

Aplica-se a

Ver também