NamedPipe 啟動

發行項
09/12/2008

此範例示範裝載服務，該服務使用 Windows Process Activation Service (WAS) 啟用透過名稱管道通訊的服務。此範例以使用者入門範例為基礎，且需要 Windows Vista 才能執行。

注意：
此範例的安裝程序與建置指示位於本主題的結尾。

此範例由用戶端主控台程式 (.exe) 和 Windows Process Activation Services (WAS) 啟動的工作處理序中裝載的服務程式庫 (.dll) 所組成。您可以在主控台視窗中看到用戶端活動。

服務會實作定義要求-回覆通訊模式的合約。合約是由 ICalculator 介面所定義，這個介面會公開數學運算 (加、減、乘、除)，如下列範例程式碼中所示。

[ServiceContract(Namespace="http://Microsoft.ServiceModel.Samples")]
public interface ICalculator
{
    [OperationContract]
    double Add(double n1, double n2);
    [OperationContract]
    double Subtract(double n1, double n2);
    [OperationContract]
    double Multiply(double n1, double n2);
    [OperationContract]
    double Divide(double n1, double n2);
}

用戶端會對指定的數學運算提出同步要求，然後服務實作計算並傳回適當結果。

// Service class that implements the service contract.
public class CalculatorService : ICalculator
{
    public double Add(double n1, double n2)
    {
        return n1 + n2;
    }
    public double Subtract(double n1, double n2)
    {
        return n1 - n2;
    }
    public double Multiply(double n1, double n2)
    {
        return n1 * n2;
    }
    public double Divide(double n1, double n2)
    {
        return n1 / n2;
    }
}

範例使用沒有安全性且經過修改的 netNamedPipeBinding 繫結。用戶端和服務的組態檔中會指定繫結。服務的繫結類型在端點項目的 binding 屬性中指定，如下列範例組態中所示。

如果您要使用安全的具名管理繫結，請將伺服器的安全性模式變更為需要的安全性設定，並在用戶端上再次執行 svcutil.exe 以取得更新的用戶端組態檔。

<system.serviceModel>
        <services>
            <service name="Microsoft.ServiceModel.Samples.CalculatorService"
               behaviorConfiguration="CalculatorServiceBehavior">

        <!-- This endpoint is exposed at the base address provided by host: net.pipe://localhost/servicemodelsamples/service.svc  -->
        <endpoint address="" 
                  binding="netNamedPipeBinding"
                  bindingConfiguration="Binding1" 
                  contract="Microsoft.ServiceModel.Samples.ICalculator" />
        <!-- the mex endpoint is explosed at net.pipe://localhost/servicemodelsamples/service.svc/mex -->
        <endpoint address="mex"
                  binding="mexNamedPipeBinding"
                  contract="IMetadataExchange" />
      </service>
        </services>    
        <bindings>
            <netNamedPipeBinding>
                <binding name="Binding1" >
                    <security mode = "None">
                    </security>
                </binding >
            </netNamedPipeBinding>
        </bindings>

    <!--For debugging purposes set the includeExceptionDetailInFaults attribute to true-->
    <behaviors>
      <serviceBehaviors>
        <behavior name="CalculatorServiceBehavior">
          <serviceMetadata />
          <serviceDebug includeExceptionDetailInFaults="False" />
        </behavior>
      </serviceBehaviors>
    </behaviors>

  </system.serviceModel>

用戶端的端點資訊設定如下列範例程式碼中所示。

<system.serviceModel>

    <client>
      <endpoint name=""
                          address="net.pipe://localhost/servicemodelsamples/service.svc" 
                          binding="netNamedPipeBinding" 
                          bindingConfiguration="Binding1" 
                          contract="Microsoft.ServiceModel.Samples.ICalculator" />
    </client>

    <bindings>

      <!--  Following is the expanded configuration section for a NetNamedPipeBinding.
            Each property is configured with the default value.   -->

      <netNamedPipeBinding>
        <binding name="Binding1" 
                         maxBufferSize="65536"
                         maxConnections="10">
          <security mode = "None">
          </security>
        </binding >

      </netNamedPipeBinding>
    </bindings>

  </system.serviceModel>

當您執行範例時，作業要求和回應會顯示在用戶端主控台視窗中。在用戶端視窗中按下 ENTER 鍵，即可關閉用戶端。

    Add(100,15.99) = 115.99
    Subtract(145,76.54) = 68.46
    Multiply(9,81.25) = 731.25
    Divide(22,7) = 3.14285714285714

    Press <ENTER> to terminate client.

若要設定、建置及執行範例

請確定您已執行 Windows Communication Foundation 範例的單次安裝程序。

此外，您必須安裝 WCF 非 HTTP 啟動元件：
1. 在 [開始] 功能表內選擇 [控制台]。
2. 選取 [程式和功能]。
3. 按一下 [開啟或關閉 Windows 元件]。
4. 展開 [Microsoft .NET Framework 3.0] 節點，然後核取 [Windows Communication Foundation 非 HTTP 啟動] 功能。
設定 Windows Process Activation Service (WAS) 以支援具名管道啟動。

為了方便起見，在位於範例目錄中稱為 AddNetPipeSiteBinding.cmd 的批次檔中實作下列兩個步驟。
1. 若要支援 net.pipe 啟動，預設的網站必須先繫結至 net.pipe 通訊協定。使用以 IIS 7.0 管理工具集安裝的 appcmd.exe 完成此操作。從提高權限的 (管理員) 命令提示中執行下列命令：
```
%windir%\system32\inetsrv\appcmd.exe set site "Default Web Site" 
-+bindings.[protocol='net.pipe',bindingInformation='*']
```
  注意：
  
  這個命令是單行文字。
  
  此命令新增繫結至預設網站的 net.pipe 網站。
2. 雖然網站中的所有應用程式共用常見的 net.pipe 繫結，但每個應用程式都可以個別啟用 net.pipe 支援。若要啟用 /servicemodelsamples 應用程式的 net.pipe，請從提高權限的命令提示中執行下列命令：
```
%windir%\system32\inetsrv\appcmd.exe set app "Default Web Site/servicemodelsamples" /enabledProtocols:http,net.pipe
```
  注意：
  
  這個命令是單行文字。
  
  這個命令可讓您使用 https://localhost/servicemodelsamples 和 net.tcp://localhost/servicemodelsamples 存取 /servicemodelsamples 應用程式。
若要建置方案的 C# 或 Visual Basic .NET 版本，請遵循建置 Windows Communication Foundation 範例中的指示。
移除您為此範例新增的 net.pipe 網站繫結。

為了方便起見，在位於範例目錄中稱為 RemoveNetPipeSiteBinding.cmd 的批次檔中實作下列兩個步驟。
1. 從提高權限的命令提示中執行下列命令，以從啟用的通訊協定清單中移除 net.tcp：
```
%windir%\system32\inetsrv\appcmd.exe set app "Default Web Site/servicemodelsamples" /enabledProtocols:http
```
  注意：
  
  這個命令必須輸入為單行文字。
2. 從提高權限的命令提示中執行下列命令以移除 net.tcp 網站繫結：
```
%windir%\system32\inetsrv\appcmd.exe set site "Default Web Site" --bindings.[protocol='net.pipe',bindingInformation='*']
```
  注意：
  
  這個命令必須輸入為單行文字。

共用方式為

NamedPipe 啟動

若要設定、建置及執行範例

其他資源