diff --git a/docs/framework/wcf/feature-details/hosting.md b/docs/framework/wcf/feature-details/hosting.md index 7b8481ccd2099..c3162afe3ccb0 100644 --- a/docs/framework/wcf/feature-details/hosting.md +++ b/docs/framework/wcf/feature-details/hosting.md @@ -32,5 +32,6 @@ The topics in the section describe service hosting. A service can be hosted by I ## See also +- [!INCLUDE[](~/includes/wcf_grpc.md)] - [Hosting Services](../hosting-services.md) - [Windows Server App Fabric Hosting Features](/previous-versions/appfabric/ee677189(v=azure.10)) diff --git a/docs/framework/wcf/getting-started-tutorial.md b/docs/framework/wcf/getting-started-tutorial.md index 23cb7c5d38a8e..8bdc9e3bde9f9 100644 --- a/docs/framework/wcf/getting-started-tutorial.md +++ b/docs/framework/wcf/getting-started-tutorial.md @@ -18,6 +18,8 @@ For sample WCF applications that you can download and run, see [Windows Communic For more in-depth information about creating services and clients, see [Basic WCF programming](basic-wcf-programming.md). +[!INCLUDE[](~/includes/wcf_grpc_heading.md)] + ## WCF tutorials The first three tutorials describe how to define a WCF service contract, how to implement it, and how to host it. The service that you create is self-hosted within a console application. You can also host services under Microsoft Internet Information Services (IIS). For more information, see [How to: Host a WCF Service in IIS](feature-details/how-to-host-a-wcf-service-in-iis.md). Although you use code to configure the service in the tutorial, you can also [configure services within a configuration file](configuring-services-using-configuration-files.md). diff --git a/docs/framework/wcf/wcf-simplification-features.md b/docs/framework/wcf/wcf-simplification-features.md index d658b6e7e2fc7..7a5506a0dbc73 100644 --- a/docs/framework/wcf/wcf-simplification-features.md +++ b/docs/framework/wcf/wcf-simplification-features.md @@ -9,6 +9,8 @@ ms.assetid: 4535a511-6064-4da0-b361-80262a891663 This topic discusses new features that make writing WCF applications simpler. +[!INCLUDE[](~/includes/wcf_grpc_heading.md)] + ## Simplified Generated Configuration Files When you add a service reference in Visual Studio or use the SvcUtil.exe tool a client configuration file is generated. In previous versions of WCF these configuration files contained the value of every binding property even if its value is the default value. In WCF 4.5 the generated configuration files contain only those binding properties that are set to a non-default value. diff --git a/docs/framework/wcf/whats-new.md b/docs/framework/wcf/whats-new.md index 510fb0565acd3..1ad1d2e009bbb 100644 --- a/docs/framework/wcf/whats-new.md +++ b/docs/framework/wcf/whats-new.md @@ -12,6 +12,8 @@ ms.assetid: 7e93fe73-af93-46b5-9f63-32f761ee40cf This topic discusses features new to Windows Communication Foundation (WCF) version 4.5. +[!INCLUDE[](~/includes/wcf_grpc_heading.md)] + ## WCF Simplification Features Much work has been done to make WCF 4.5 applications easier to develop and maintain. For more information, see [WCF Simplification Features](wcf-simplification-features.md). diff --git a/docs/framework/wcf/whats-wcf.md b/docs/framework/wcf/whats-wcf.md index a44dad948f149..e8f8646d6c175 100644 --- a/docs/framework/wcf/whats-wcf.md +++ b/docs/framework/wcf/whats-wcf.md @@ -24,6 +24,8 @@ Windows Communication Foundation (WCF) is a framework for building service-orien While creating such applications was possible prior to the existence of WCF, WCF makes the development of endpoints easier than ever. In summary, WCF is designed to offer a manageable approach to creating Web services and Web service clients. +[!INCLUDE[](~/includes/wcf_grpc_heading.md)] + ## Features of WCF WCF includes the following set of features. For more information, see [WCF Feature Details](./feature-details/index.md). diff --git a/includes/wcf_grpc.md b/includes/wcf_grpc.md new file mode 100644 index 0000000000000..bef553701b057 --- /dev/null +++ b/includes/wcf_grpc.md @@ -0,0 +1,12 @@ +gRPC is a modern RPC framework that is a popular alternative to WCF. gRPC is built on top of HTTP/2, which provides a number of advantages over WCF, including: + +* Performance: gRPC is much more efficient than WCF, especially for long-running connections. +* Scalability: gRPC is designed to scale to large numbers of clients and servers. +* Security: gRPC supports a variety of security mechanisms, including TLS and authentication. +* Cross-platform: gRPC is platform-neutral and can be used with a variety of programming languages. + +For more information on developing or migrating WCF apps to gRPC, see: + +* [Why we recommend gRPC for WCF developers](/dotnet/architecture/grpc-for-wcf-developers/why-grpc) +* [Comparing WCF to gRPC](/dotnet/architecture/grpc-for-wcf-developers/wcf-services-to-grpc-comparison) +* [Introduction to gRPC for WCF developers](/dotnet/architecture/grpc-for-wcf-developers/introduction) diff --git a/includes/wcf_grpc_heading.md b/includes/wcf_grpc_heading.md new file mode 100644 index 0000000000000..aad95eb85010f --- /dev/null +++ b/includes/wcf_grpc_heading.md @@ -0,0 +1,3 @@ +## gRPC as an alternative to WCF + +[!INCLUDE[](~/includes/wcf_grpc.md)]