HttpServerChannel Sınıf
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
İletileri iletmek için HTTP protokolunu kullanan uzak çağrılar için bir sunucu kanalı uygular.
public ref class HttpServerChannel : System::Runtime::Remoting::Channels::BaseChannelWithProperties, System::Runtime::Remoting::Channels::IChannelReceiver, System::Runtime::Remoting::Channels::IChannelReceiverHook
public class HttpServerChannel : System.Runtime.Remoting.Channels.BaseChannelWithProperties, System.Runtime.Remoting.Channels.IChannelReceiver, System.Runtime.Remoting.Channels.IChannelReceiverHook
type HttpServerChannel = class
inherit BaseChannelWithProperties
interface IChannelReceiver
interface IChannel
interface IChannelReceiverHook
Public Class HttpServerChannel
Inherits BaseChannelWithProperties
Implements IChannelReceiver, IChannelReceiverHook
- Devralma
- Uygulamalar
Örnekler
Aşağıdaki kod örneği, uzaktan HttpServerChannel iletişim sunucusu ve istemcisini ayarlamak için bir nesnenin nasıl kullanılacağını gösterir. Örnekte üç bölüm bulunur:
Sunucu
İstemci
Sunucu ve istemci tarafından kullanılan uzak nesne
Aşağıdaki kod örneğinde bir sunucu gösterilmektedir.
#using <System.dll>
#using <System.Runtime.Remoting.dll>
#using "common.dll"
using namespace System;
using namespace System::Runtime::Remoting;
using namespace System::Runtime::Remoting::Channels;
using namespace System::Runtime::Remoting::Channels::Http;
int main()
{
// Create the server channel.
HttpServerChannel^ serverChannel = gcnew HttpServerChannel( 9090 );
// Register the server channel.
ChannelServices::RegisterChannel( serverChannel );
// Display the channel's scheme.
Console::WriteLine( L"The channel scheme is {0}.", serverChannel->ChannelScheme );
// Display the channel's URI.
Console::WriteLine( L"The channel URI is {0}.", serverChannel->GetChannelUri() );
// Expose an object for remote calls.
RemotingConfiguration::RegisterWellKnownServiceType(
RemoteObject::typeid, L"RemoteObject.rem", WellKnownObjectMode::Singleton );
// Get the channel's sink chain.
IServerChannelSink^ sinkChain = serverChannel->ChannelSinkChain;
Console::WriteLine( L"The type of the server channel's sink chain is {0}.", sinkChain->GetType() );
// See if the channel wants to listen.
bool wantsToListen = serverChannel->WantsToListen;
Console::WriteLine( L"The value of WantsToListen is {0}.", wantsToListen );
// Parse the channel's URI.
array<String^>^ urls = serverChannel->GetUrlsForUri( L"RemoteObject.rem" );
if ( urls->Length > 0 )
{
String^ objectUrl = urls[ 0 ];
String^ objectUri;
String^ channelUri = serverChannel->Parse( objectUrl, objectUri );
Console::WriteLine( L"The object URI is {0}.", objectUri );
Console::WriteLine( L"The channel URI is {0}.", channelUri );
Console::WriteLine( L"The object URL is {0}.", objectUrl );
}
// Wait for the user prompt.
Console::WriteLine( L"Press ENTER to exit the server." );
Console::ReadLine();
Console::WriteLine( L"The server is exiting." );
}
using System;
using System.Runtime.Remoting;
using System.Runtime.Remoting.Channels;
using System.Runtime.Remoting.Channels.Http;
public class Server
{
public static void Main(string[] args)
{
// Create the server channel.
HttpServerChannel serverChannel = new HttpServerChannel(9090);
// Register the server channel.
ChannelServices.RegisterChannel(serverChannel);
// Display the channel's scheme.
Console.WriteLine("The channel scheme is {0}.",
serverChannel.ChannelScheme);
// Display the channel's URI.
Console.WriteLine("The channel URI is {0}.",
serverChannel.GetChannelUri());
// Expose an object for remote calls.
RemotingConfiguration.RegisterWellKnownServiceType(
typeof(RemoteObject), "RemoteObject.rem",
WellKnownObjectMode.Singleton);
// Get the channel's sink chain.
IServerChannelSink sinkChain = serverChannel.ChannelSinkChain;
Console.WriteLine(
"The type of the server channel's sink chain is {0}.",
sinkChain.GetType().ToString());
// See if the channel wants to listen.
bool wantsToListen = serverChannel.WantsToListen;
Console.WriteLine(
"The value of WantsToListen is {0}.",
wantsToListen);
// Parse the channel's URI.
string[] urls = serverChannel.GetUrlsForUri("RemoteObject.rem");
if (urls.Length > 0)
{
string objectUrl = urls[0];
string objectUri;
string channelUri =
serverChannel.Parse(objectUrl, out objectUri);
Console.WriteLine("The object URI is {0}.", objectUri);
Console.WriteLine("The channel URI is {0}.", channelUri);
Console.WriteLine("The object URL is {0}.", objectUrl);
}
// Wait for the user prompt.
Console.WriteLine("Press ENTER to exit the server.");
Console.ReadLine();
Console.WriteLine("The server is exiting.");
}
}
Aşağıdaki kod örneğinde bu sunucu için bir istemci gösterilmektedir.
#using <System.dll>
#using <System.Runtime.Remoting.dll>
#using "common.dll"
using namespace System;
using namespace System::Runtime::Remoting;
using namespace System::Runtime::Remoting::Channels;
using namespace System::Runtime::Remoting::Channels::Http;
void main()
{
// Create the channel.
HttpClientChannel^ channel = gcnew HttpClientChannel;
// Register the channel.
ChannelServices::RegisterChannel( channel );
// Register as client for remote object.
WellKnownClientTypeEntry^ remoteType = gcnew WellKnownClientTypeEntry(
RemoteObject::typeid,L"http://localhost:9090/RemoteObject.rem" );
RemotingConfiguration::RegisterWellKnownClientType( remoteType );
// Create an instance of the remote object.
RemoteObject^ service = gcnew RemoteObject;
// Invoke a method on the remote object.
Console::WriteLine( L"The client is invoking the remote object." );
Console::WriteLine( L"The remote object has been called {0} times.", service->GetCount() );
}
using System;
using System.Runtime.Remoting;
using System.Runtime.Remoting.Channels;
using System.Runtime.Remoting.Channels.Http;
public class Client
{
public static void Main(string[] args)
{
// Create the channel.
HttpClientChannel channel = new HttpClientChannel();
// Register the channel.
ChannelServices.RegisterChannel(channel);
// Register as client for remote object.
WellKnownClientTypeEntry remoteType = new WellKnownClientTypeEntry(
typeof(RemoteObject),"http://localhost:9090/RemoteObject.rem");
RemotingConfiguration.RegisterWellKnownClientType(remoteType);
// Create an instance of the remote object.
RemoteObject service = new RemoteObject();
// Invoke a method on the remote object.
Console.WriteLine("The client is invoking the remote object.");
Console.WriteLine("The remote object has been called {0} times.",
service.GetCount());
}
}
Aşağıdaki kod örneği, sunucu ve istemci tarafından kullanılan uzak nesneyi gösterir.
using namespace System;
using namespace System::Runtime::Remoting;
// Remote object.
public ref class RemoteObject: public MarshalByRefObject
{
private:
static int callCount = 0;
public:
int GetCount()
{
callCount++;
return (callCount);
}
};
using System;
using System.Runtime.Remoting;
// Remote object.
public class RemoteObject : MarshalByRefObject
{
private int callCount = 0;
public int GetCount()
{
callCount++;
return(callCount);
}
}
Açıklamalar
Kanallar iletileri uzaktan iletişim sınırları (örneğin, uygulama etki alanlarındaki bilgisayarlar arasında) taşır. sınıfı, HttpServerChannel HTTP protokolunu kullanarak iletileri taşır.
Kanallar, uzaktan aramaları taşımak için .NET Framework uzaktan iletişim altyapısı tarafından kullanılır. İstemci uzak bir nesneye çağrı yaptığında, çağrı bir istemci kanalı tarafından gönderilen ve bir sunucu kanalı tarafından alınan bir iletide seri hale getirilir. Daha sonra seri durumdan çıkarılır ve işlenir. Döndürülen değerler sunucu kanalı tarafından iletilir ve istemci kanalı tarafından alınır.
sunucu tarafında iletilerin ek işlenmesini gerçekleştirmek için, tarafından HttpServerChannel işlenen tüm iletilerin IServerChannelSinkProvider geçirildiği bir uygulamasını belirtebilirsiniz.
, HttpServerChannel ikili veya SOAP biçiminde seri hale getirilmiş iletileri kabul eder.
Bir HttpServerChannel nesnenin çalışma zamanında bir yapılandırma dosyasında (statik RemotingConfiguration.Configure yöntemi çağırarak) veya program aracılığıyla (bir koleksiyonu oluşturucuya geçirerek IDictionary ) ayarlanabilen HttpServerChannel ilişkili yapılandırma özellikleri vardır. Bu yapılandırma özelliklerinin listesi için HttpServerChannelbelgelerine bakın.
Oluşturucular
HttpServerChannel() |
HttpServerChannel sınıfının yeni bir örneğini başlatır. |
HttpServerChannel(IDictionary, IServerChannelSinkProvider) |
Belirtilen kanal özellikleri ve havuz ile sınıfının yeni bir örneğini HttpServerChannel başlatır. |
HttpServerChannel(Int32) |
Belirtilen bağlantı noktasında dinleyen sınıfının yeni bir örneğini HttpServerChannel başlatır. |
HttpServerChannel(String, Int32) |
Belirtilen ada sahip ve belirtilen bağlantı noktasını dinleyen sınıfının yeni bir örneğini HttpServerChannel başlatır. |
HttpServerChannel(String, Int32, IServerChannelSinkProvider) |
Belirtilen bağlantı noktasında belirtilen bağlantı noktasında sınıfının yeni bir örneğini HttpServerChannel başlatır ve belirtilen bağlantı noktasını dinler ve belirtilen havuzu kullanır. |
Alanlar
SinksWithProperties |
Kanal havuzu yığınındaki en üst kanal havuzu gösterir. (Devralındığı yer: BaseChannelWithProperties) |
Özellikler
ChannelData |
Kanala özgü verileri alır. |
ChannelName |
Geçerli kanalın adını alır. |
ChannelPriority |
Geçerli kanalın önceliğini alır. |
ChannelScheme |
Bağlanacak dinleyici türünü alır (örneğin, "http"). |
ChannelSinkChain |
Geçerli kanalın kullandığı kanal havuzu zincirini alır. |
Count |
Kanal nesnesiyle ilişkili özelliklerin sayısını alır. (Devralındığı yer: BaseChannelObjectWithProperties) |
IsFixedSize |
Kanal nesnesine girilebilen özelliklerin sayısının sabit olup olmadığını gösteren bir değer alır. (Devralındığı yer: BaseChannelObjectWithProperties) |
IsReadOnly |
Kanal nesnesindeki özellik koleksiyonunun salt okunur olup olmadığını gösteren bir değer alır. (Devralındığı yer: BaseChannelObjectWithProperties) |
IsSynchronized |
Kanal nesnesi özelliklerinin sözlüğün eşitlenip eşitlenmediğini gösteren bir değer alır. (Devralındığı yer: BaseChannelObjectWithProperties) |
Item[Object] |
Belirtilen kanal özelliğini döndürür. |
Keys |
Kanal özelliklerinin ilişkili olduğu anahtarlardan birini ICollection alır. |
Properties |
Geçerli kanal nesnesiyle ilişkili kanal özelliklerinden birini IDictionary alır. (Devralındığı yer: BaseChannelWithProperties) |
SyncRoot |
erişimi BaseChannelObjectWithPropertieseşitlemek için kullanılan bir nesnesi alır. (Devralındığı yer: BaseChannelObjectWithProperties) |
Values |
Kanal nesnesiyle ilişkili özelliklerin değerlerinin bir ICollection değerini alır. (Devralındığı yer: BaseChannelObjectWithProperties) |
WantsToListen |
Dış dinleyici hizmetine bağlanmak isteyip istemediğinizi IChannelReceiverHook gösteren bir Boole değeri alır. |
Yöntemler
Add(Object, Object) |
Bir NotSupportedExceptionoluşturur. (Devralındığı yer: BaseChannelObjectWithProperties) |
AddHookChannelUri(String) |
Kanal kancasının dinlemesi gereken bir URI ekler. |
Clear() |
Bir NotSupportedExceptionoluşturur. (Devralındığı yer: BaseChannelObjectWithProperties) |
Contains(Object) |
Kanal nesnesinin belirtilen anahtarla ilişkilendirilmiş bir özellik içerip içermediğini gösteren bir değer döndürür. (Devralındığı yer: BaseChannelObjectWithProperties) |
CopyTo(Array, Int32) |
Bir NotSupportedExceptionoluşturur. (Devralındığı yer: BaseChannelObjectWithProperties) |
Equals(Object) |
Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object) |
GetChannelUri() |
Geçerli kanalın URI'sini döndürür. |
GetEnumerator() |
Kanal nesnesiyle ilişkili tüm özellikleri numaralandıran bir IDictionaryEnumerator döndürür. (Devralındığı yer: BaseChannelObjectWithProperties) |
GetHashCode() |
Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object) |
GetType() |
Type Geçerli örneğini alır. (Devralındığı yer: Object) |
GetUrlsForUri(String) |
Geçerli HttpChannelüzerinde barındırılan belirtilen URI'ye sahip bir nesnenin tüm URL'lerinden oluşan bir dizi döndürür. |
MemberwiseClone() |
Geçerli Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object) |
Parse(String, String) |
Belirtilen URL'den kanal URI'sini ve uzak iyi bilinen nesne URI'sini ayıklar. |
Remove(Object) |
Bir NotSupportedExceptionoluşturur. (Devralındığı yer: BaseChannelObjectWithProperties) |
StartListening(Object) |
Geçerli kanala istekleri dinlemeye başlamasını emreder. |
StopListening(Object) |
Geçerli kanala istekleri dinlemeyi durdurmasını emreder. |
ToString() |
Geçerli nesneyi temsil eden dizeyi döndürür. (Devralındığı yer: Object) |
Belirtik Arabirim Kullanımları
IEnumerable.GetEnumerator() |
Kanal nesnesiyle ilişkili tüm özellikleri numaralandıran bir IEnumerator döndürür. (Devralındığı yer: BaseChannelObjectWithProperties) |
Uzantı Metotları
Cast<TResult>(IEnumerable) |
öğesinin IEnumerable öğelerini belirtilen türe atar. |
OfType<TResult>(IEnumerable) |
Öğesinin IEnumerable öğelerini belirtilen türe göre filtreler. |
AsParallel(IEnumerable) |
Sorgunun paralelleştirilmesini etkinleştirir. |
AsQueryable(IEnumerable) |
bir IEnumerable öğesini öğesine IQueryabledönüştürür. |