ChannelServices.RegisterChannel Metod
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Överlagringar
| Name | Description |
|---|---|
| RegisterChannel(IChannel) |
Föråldrad.
Registrerar en kanal med kanaltjänsterna. RegisterChannel(IChannel) är föråldrad. Använd RegisterChannel(IChannel, Boolean) i stället. |
| RegisterChannel(IChannel, Boolean) |
Registrerar en kanal med kanaltjänsterna. |
RegisterChannel(IChannel)
Varning
Use System.Runtime.Remoting.ChannelServices.RegisterChannel(IChannel chnl, bool ensureSecurity) instead.
Registrerar en kanal med kanaltjänsterna. RegisterChannel(IChannel) är föråldrad. Använd RegisterChannel(IChannel, Boolean) i stället.
public:
static void RegisterChannel(System::Runtime::Remoting::Channels::IChannel ^ chnl);
public static void RegisterChannel(System.Runtime.Remoting.Channels.IChannel chnl);
[System.Obsolete("Use System.Runtime.Remoting.ChannelServices.RegisterChannel(IChannel chnl, bool ensureSecurity) instead.", false)]
public static void RegisterChannel(System.Runtime.Remoting.Channels.IChannel chnl);
static member RegisterChannel : System.Runtime.Remoting.Channels.IChannel -> unit
[<System.Obsolete("Use System.Runtime.Remoting.ChannelServices.RegisterChannel(IChannel chnl, bool ensureSecurity) instead.", false)>]
static member RegisterChannel : System.Runtime.Remoting.Channels.IChannel -> unit
Public Shared Sub RegisterChannel (chnl As IChannel)
Parametrar
- chnl
- IChannel
Kanalen som ska registreras.
- Attribut
Undantag
Parametern chnl är null.
Kanalen har redan registrerats.
Minst en av anroparna högre i anropsstacken har inte behörighet att konfigurera fjärrkommunikationstyper och kanaler.
Kommentarer
Note
RegisterChannel(IChannel) är föråldrad. Använd RegisterChannel(IChannel, Boolean) i stället.
Metoden RegisterChannel tar in IChannel gränssnittet från ett kanalobjekt. Kanalens ChannelName måste vara unik, eller så måste kanalen vara anonym. En kanal är anonym om den IChannel.ChannelName är inställd på antingen null eller Empty med hjälp av konfigurationsegenskapen name .
Du kan inte registrera två kanaler med samma namn i en AppDomain. Som standard är namnet på en HttpChannel "http" och namnet på en TcpChannel är "tcp". Om du vill registrera två kanaler av samma typ måste du därför ange ett annat namn för en av dem via konfigurationsegenskaper.
Mer information om egenskaper för kanalkonfiguration finns i HttpChannel, och <kanalelement> (mall).
Gäller för
RegisterChannel(IChannel, Boolean)
Registrerar en kanal med kanaltjänsterna.
public:
static void RegisterChannel(System::Runtime::Remoting::Channels::IChannel ^ chnl, bool ensureSecurity);
public static void RegisterChannel(System.Runtime.Remoting.Channels.IChannel chnl, bool ensureSecurity);
static member RegisterChannel : System.Runtime.Remoting.Channels.IChannel * bool -> unit
Public Shared Sub RegisterChannel (chnl As IChannel, ensureSecurity As Boolean)
Parametrar
- chnl
- IChannel
Kanalen som ska registreras.
- ensureSecurity
- Boolean
true säkerställer att säkerheten är aktiverad. annars false. Om värdet anges till false påverkas inte säkerhetsinställningen på TCP- eller IPC-kanalen.
Undantag
Parametern chnl är null.
Kanalen har redan registrerats.
Minst en av anroparna högre i anropsstacken har inte behörighet att konfigurera fjärrkommunikationstyper och kanaler.
Stöds inte för HttpServerChannel. Värd för tjänsten med hjälp av Internet Information Services (IIS) om du behöver en säker HTTP-kanal.
Kommentarer
Metoden RegisterChannel(IChannel, Boolean) tar emot IChannel gränssnittet från ett kanalobjekt. Kanalens ChannelName måste vara unik, eller så måste kanalen vara anonym. En kanal är anonym om den IChannel.ChannelName är inställd på antingen null eller Empty med hjälp av konfigurationsegenskapen name .
Du kan inte registrera två kanaler med samma namn i en AppDomain. Som standard är namnet på en HttpChannel "http" och namnet på en TcpChannel är "tcp". Om du vill registrera två kanaler av samma typ måste du därför ange ett annat namn för en av dem via konfigurationsegenskaper.
Mer information om egenskaper för kanalkonfiguration finns i Egenskaper för kanal- och formateringskonfiguration och <kanalelement> (mall).
Om parametern ensureSecurity är inställd truepå avgör fjärrkommunikationssystemet om kanalen implementerar ISecurableChanneloch i så fall aktiverar kryptering och digitala signaturer. Ett undantag utlöses om kanalen inte implementerar ISecurableChannel.
Note
Inställningen ensureSecurity till true genererar en RemotingException för HttpServerChannel kanalen på alla plattformar. Du måste vara värd för din tjänst i IIS om du vill använda en säker http-kanal.