ServiceHostBase Класс

Определение

Расширяет класс ServiceHostBase для реализации узлов, предоставляющих пользовательские модели программирования.Extends the ServiceHostBase class to implement hosts that expose custom programming models.

public ref class ServiceHostBase abstract : System::ServiceModel::Channels::CommunicationObject, IDisposable, System::ServiceModel::IExtensibleObject<System::ServiceModel::ServiceHostBase ^>
public abstract class ServiceHostBase : System.ServiceModel.Channels.CommunicationObject, IDisposable, System.ServiceModel.IExtensibleObject<System.ServiceModel.ServiceHostBase>
type ServiceHostBase = class
    inherit CommunicationObject
    interface IExtensibleObject<ServiceHostBase>
    interface IDisposable
Public MustInherit Class ServiceHostBase
Inherits CommunicationObject
Implements IDisposable, IExtensibleObject(Of ServiceHostBase)
Наследование
ServiceHostBase
Производный
Реализации

Примеры

В этом образце используется класс ServiceHost, унаследованный от класса ServiceHostBase.This sample uses the ServiceHost class, which is derived from ServiceHostBase.

// Host the service within this EXE console application.
public static void Main()
{
  using (ServiceHost serviceHost = new ServiceHost(typeof(CalculatorService)))
  {
    try
    {
      // Open the ServiceHost to start listening for messages.
      serviceHost.Open();

        // The service can now be accessed.
      Console.WriteLine("The service is ready.");
      Console.WriteLine("Press <ENTER> to terminate service.");
      Console.ReadLine();

      // Close the ServiceHost.
      serviceHost.Close();
    }
    catch (TimeoutException timeProblem)
    {
      Console.WriteLine(timeProblem.Message);
      Console.ReadLine();
    }
    catch (CommunicationException commProblem)
    {
      Console.WriteLine(commProblem.Message);
      Console.ReadLine();
    }
  }
}
' Host the service within this EXE console application.
Public Shared Sub Main()
    ' Create a ServiceHost for the CalculatorService type and use the base address from config.
    Using svcHost As New ServiceHost(GetType(CalculatorService))
        Try
            ' Open the ServiceHost to start listening for messages.
            svcHost.Open()

            ' The service can now be accessed.
            Console.WriteLine("The service is ready.")
            Console.WriteLine("Press <ENTER> to terminate service.")
            Console.WriteLine()
            Console.ReadLine()

            'Close the ServiceHost.
            svcHost.Close()

        Catch timeout As TimeoutException
            Console.WriteLine(timeout.Message)
            Console.ReadLine()
        Catch commException As CommunicationException
            Console.WriteLine(commException.Message)
            Console.ReadLine()
        End Try
    End Using

End Sub

Комментарии

Используйте класс ServiceHostBase для создания узлов, предоставляющих пользовательскую модель программирования.Use the ServiceHostBase class to create hosts that provide a custom programming model. Модель программирования службы Windows Communication Foundation (WCF) использует ServiceHost класс.The Windows Communication Foundation (WCF) service programming model uses the ServiceHost class.

Особое примечание для пользователей управляемого кода C++, создающих классы, унаследованные от данного.Special note for Managed C++ users deriving from this class:

  • Поместите код очистки в блок (On)(Begin)Close (или OnAbort), а не в деструктор.Put your cleanup code in (On)(Begin)Close (and/or OnAbort), not in a destructor.

  • Избегайте использования деструкторов, поскольку они приводят к тому, что компилятор автоматически создает IDisposable.Avoid destructors; they cause the compiler to auto-generate IDisposable.

  • Избегайте использования нессылочных членов, поскольку они приводят к тому, что компилятор автоматически создает IDisposable.Avoid non-reference members; they can cause the compiler to auto-generate IDisposable.

  • Избегайте использования методов завершения. При включении этого метода необходимо подавить предупреждение построения и вызвать SuppressFinalize(Object) и сам метод завершения из блока (On)(Begin)Close (или OnAbort) для эмуляции автоматического поведения IDisposable.Avoid finalizers; but if you include one, you should suppress the build warning and call SuppressFinalize(Object) and the finalizer itself from (On)(Begin)Close (and/or OnAbort) to emulate what would have been the auto-generated IDisposable behavior.

Конструкторы

ServiceHostBase()

Инициализирует новый экземпляр класса ServiceHostBase.Initializes a new instance of the ServiceHostBase class.

Свойства

Authentication

Возвращает поведение проверки подлинности службы.Gets the service authentication behavior.

Authorization

Возвращает поведение авторизации для размещенной службы.Gets the authorization behavior for the service hosted.

BaseAddresses

Возвращает базовые адреса, используемые размещенной службой.Gets the base addresses used by the hosted service.

ChannelDispatchers

Возвращает коллекцию диспетчеров каналов, используемых узлом службы.Gets the collection of channel dispatchers used by the service host.

CloseTimeout

Возвращает или задает интервал времени, выделенный для операции закрытия узла службы.Gets or sets the interval of time allowed for the service host to close.

Credentials

Возвращает учетные данные для размещенной службы.Gets the credential for the service hosted.

DefaultCloseTimeout

Возвращает интервал времени по умолчанию, выделенный для операции закрытия узла службы.Gets the default interval of time allowed for the service host to close.

DefaultOpenTimeout

Возвращает интервал времени по умолчанию, выделенный для операции открытия узла службы.Gets the default interval of time allowed for the service host to open.

Description

Возвращает описание размещенной службы.Gets the description of the service hosted.

Extensions

Возвращает расширения для текущего заданного узла службы.Gets the extensions for the current specified service host.

ImplementedContracts

Извлекает контракты, реализованные размещенной службой.Retrieves the contracts implemented by the service hosted.

IsDisposed

Возвращает значение, указывающее, удален ли объект связи.Gets a value that indicates whether the communication object has been disposed.

(Унаследовано от CommunicationObject)
ManualFlowControlLimit

Возвращает или задает предел управления потоками для сообщений, полученных размещенной службой.Gets or sets the flow control limit for messages received by the service hosted.

OpenTimeout

Возвращает или задает интервал времени, выделенный для операции открытия узла службы.Gets or sets the interval of time allowed for the service host to open.

State

Возвращает значение, которое указывает на текущее состояние объекта связи.Gets a value that indicates the current state of the communication object.

(Унаследовано от CommunicationObject)
ThisLock

Возвращает взаимно исключающую блокировку, которая защищает экземпляр класса в процессе перехода между состояниями.Gets the mutually exclusive lock that protects the class instance during a state transition.

(Унаследовано от CommunicationObject)

Методы

Abort()

Вызывает мгновенный переход объекта связи из текущего состояния в состояние закрытия.Causes a communication object to transition immediately from its current state into the closing state.

(Унаследовано от CommunicationObject)
AddBaseAddress(Uri)

Добавляет базовый адрес в узел службы.Adds a base address to the service host.

AddDefaultEndpoints()

Добавляет конечные точки службы для всех базовых адресов в каждом контракте, найденных в узле службы, имеющих привязку по умолчанию.Adds service endpoints for all base addresses in each contract found in the service host with the default binding.

AddServiceEndpoint(ServiceEndpoint)

Добавляет заданную конечную точку службы в размещенную службу.Adds the specified service endpoint to the hosted service.

AddServiceEndpoint(String, Binding, String)

Добавляет конечную точку службы в размещенную службу с указанными контрактом, привязкой и адресом конечной точки.Adds a service endpoint to the hosted service with a specified contract, binding, and endpoint address.

AddServiceEndpoint(String, Binding, String, Uri)

Добавляет конечную точку службы в размещенную службу с указанными контрактом, привязкой, адресом конечной точки и универсальным кодом ресурса (URI), содержащим адрес, по которому служба выполняет прослушивание.Adds a service endpoint to the hosted service with a specified contract, binding, endpoint address and URI that contains the address at which it listens.

AddServiceEndpoint(String, Binding, Uri)

Добавляет конечную точку службы в размещенную службу с указанными контрактом, привязкой и универсальным кодом ресурса (URI), содержащим адрес конечной точки.Adds a service endpoint to the hosted service with a specified contract, binding, and a URI that contains the endpoint address.

AddServiceEndpoint(String, Binding, Uri, Uri)

Добавляет конечную точку службы в размещенную службу с указанными контрактом, привязкой и универсальными кодами ресурса (URI), содержащими адреса конечных точек и прослушивания.Adds a service endpoint to the hosted service with the specified contract, binding, and URIs that contain the endpoint and listening addresses.

ApplyConfiguration()

Загружает данные с описанием службы из файла конфигурации и применяет их к создаваемой среде выполнения.Loads the service description information from the configuration file and applies it to the runtime being constructed.

BeginClose(AsyncCallback, Object)

Начинает асинхронную операцию закрытия объекта связи.Begins an asynchronous operation to close a communication object.

(Унаследовано от CommunicationObject)
BeginClose(TimeSpan, AsyncCallback, Object)

Начинает асинхронную операцию закрытия объекта связи с заданным временем ожидания.Begins an asynchronous operation to close a communication object with a specified timeout.

(Унаследовано от CommunicationObject)
BeginOpen(AsyncCallback, Object)

Начинает асинхронную операцию открытия объекта связи.Begins an asynchronous operation to open a communication object.

(Унаследовано от CommunicationObject)
BeginOpen(TimeSpan, AsyncCallback, Object)

Начинает асинхронную операцию открытия объекта связи в течение заданного интервала времени.Begins an asynchronous operation to open a communication object within a specified interval of time.

(Унаследовано от CommunicationObject)
Close()

Вызывает переход объекта связи из текущего состояния в состояние Closed.Causes a communication object to transition from its current state into the closed state.

(Унаследовано от CommunicationObject)
Close(TimeSpan)

Вызывает переход объекта связи из его текущего состояния в состояние Closed в течение заданного интервала времени.Causes a communication object to transition from its current state into the closed state within a specified interval of time.

(Унаследовано от CommunicationObject)
CreateDescription(IDictionary<String,ContractDescription>)

При реализации в производном классе создает описание размещенной службы.When implemented in a derived class, creates the description of the hosted service.

EndClose(IAsyncResult)

Завершает асинхронную операцию закрытия объекта связи.Completes an asynchronous operation to close a communication object.

(Унаследовано от CommunicationObject)
EndOpen(IAsyncResult)

Завершает асинхронную операцию открытия объекта связи.Completes an asynchronous operation to open a communication object.

(Унаследовано от CommunicationObject)
Equals(Object)

Определяет, равен ли заданный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Унаследовано от Object)
Fault()

Вызывает переход объекта связи из текущего состояния в состояние Faulted.Causes a communication object to transition from its current state into the faulted state.

(Унаследовано от CommunicationObject)
GetCommunicationObjectType()

Возвращает тип объекта связи.Gets the type of communication object.

(Унаследовано от CommunicationObject)
GetHashCode()

Служит хэш-функцией по умолчанию.Serves as the default hash function.

(Унаследовано от Object)
GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Унаследовано от Object)
IncrementManualFlowControlLimit(Int32)

Увеличивает значение предела скорости потока сообщений в размещенную службу на заданную величину.Increases the limit on the flow rate of messages to the hosted service by a specified increment.

InitializeDescription(UriSchemeKeyedCollection)

Создает и инициализирует узел службы с описаниями контрактов и служб.Creates and initializes the service host with the contract and service descriptions.

InitializeRuntime()

Инициализирует среду выполнения для узла службы.Initializes the runtime for the service host.

LoadConfigurationSection(ServiceElement)

Загружает элемент службы из файла конфигурации размещенной службы.Loads the service element from the configuration file of the hosted service.

MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Унаследовано от Object)
OnAbort()

Прерывает работу службы.Aborts the service.

OnBeginClose(TimeSpan, AsyncCallback, Object)

Начинает асинхронную операцию, вызванную закрытием узла службы.Begins an asynchronous operation invoked on the close of the service host.

OnBeginOpen(TimeSpan, AsyncCallback, Object)

Начинает асинхронную операцию, вызванную открытием узла службы.Begins an asynchronous operation invoked on the opening of the service host.

OnClose(TimeSpan)

Закрывает размещенную службу, включая диспетчеры каналов и связанные контексты и прослушиватели экземпляра.Closes down the hosted service, including their channel dispatchers and associated instance contexts and listeners.

OnClosed()

Освобождает ресурсы, используемые узлом службы.Releases resources used by the service host.

OnClosing()

Вызывается в процессе перехода объекта связи в состояние закрытия.Invoked during the transition of a communication object into the closing state.

(Унаследовано от CommunicationObject)
OnEndClose(IAsyncResult)

Завершает асинхронную операцию, вызванную закрытием узла службы.Completes an asynchronous operation invoked on the closing of the service host.

OnEndOpen(IAsyncResult)

Завершает асинхронную операцию, вызванную открытием узла службы.Completes an asynchronous operation invoked on the opening of the service host.

OnFaulted()

Вставляет операцию обработки объекта связи после перехода объекта в состояние Faulted в связи с вызовом синхронной операции ошибки.Inserts processing on a communication object after it transitions to the faulted state due to the invocation of a synchronous fault operation.

(Унаследовано от CommunicationObject)
OnOpen(TimeSpan)

Открывает диспетчеры каналов.Opens the channel dispatchers.

OnOpened()

Возвращает учетные данные службы, проверку подлинности службы и поведение авторизации для размещенной службы.Gets the service credentials,service authentication and authorization behavior for the hosted service.

OnOpening()

Вызывается в процессе перехода объекта связи в состояние открытия.Invoked during the transition of a communication object into the opening state.

(Унаследовано от CommunicationObject)
Open()

Вызывает переход объекта связи из состояния Created в состояние Opened.Causes a communication object to transition from the created state into the opened state.

(Унаследовано от CommunicationObject)
Open(TimeSpan)

Вызывает переход объекта связи из состояния Created в состояние Opened в течение заданного интервала времени.Causes a communication object to transition from the created state into the opened state within a specified interval of time.

(Унаследовано от CommunicationObject)
ReleasePerformanceCounters()

Освобождает счетчики производительности диспетчера каналов и служб для размещенной службы.Releases the service and channel dispatcher performance counters for the hosted service.

SetEndpointAddress(ServiceEndpoint, String)

Задает в качестве адреса указанной конечной точки указанный адрес.Sets the endpoint address of the specified endpoint to the specified address.

ThrowIfDisposed()

Вызывает исключение, если объект связи удален.Throws an exception if the communication object is disposed.

(Унаследовано от CommunicationObject)
ThrowIfDisposedOrImmutable()

Создает исключение, если для свойства объекта связи State не установлено значение Created.Throws an exception if the communication object the State property is not set to the Created state.

(Унаследовано от CommunicationObject)
ThrowIfDisposedOrNotOpen()

Создает исключение, если объект связи не находится в состоянии Opened.Throws an exception if the communication object is not in the Opened state.

(Унаследовано от CommunicationObject)
ToString()

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

(Унаследовано от Object)

События

Closed

Происходит при переходе объекта связи в состояние Closed.Occurs when a communication object transitions into the closed state.

(Унаследовано от CommunicationObject)
Closing

Происходит при переходе объекта связи в состояние закрытия.Occurs when a communication object transitions into the closing state.

(Унаследовано от CommunicationObject)
Faulted

Происходит при переходе объекта связи в состояние Faulted.Occurs when a communication object transitions into the faulted state.

(Унаследовано от CommunicationObject)
Opened

Происходит при переходе объекта связи в состояние Opened.Occurs when a communication object transitions into the opened state.

(Унаследовано от CommunicationObject)
Opening

Происходит при переходе объекта связи в состояние открытия.Occurs when a communication object transitions into the opening state.

(Унаследовано от CommunicationObject)
UnknownMessageReceived

Происходит при получении неизвестного сообщения.Occurs when an unknown message is received.

Явные реализации интерфейса

IDisposable.Dispose()

Закрывает узел службы.Closes the service host.

Применяется к