Grpc.Net.Client.Web 2.52.0-pre1

Prefix Reserved
This is a prerelease version of Grpc.Net.Client.Web.
There is a newer version of this package available.
See the version list below for details.
dotnet add package Grpc.Net.Client.Web --version 2.52.0-pre1
                    
NuGet\Install-Package Grpc.Net.Client.Web -Version 2.52.0-pre1
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Grpc.Net.Client.Web" Version="2.52.0-pre1" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="Grpc.Net.Client.Web" Version="2.52.0-pre1" />
                    
Directory.Packages.props
<PackageReference Include="Grpc.Net.Client.Web" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add Grpc.Net.Client.Web --version 2.52.0-pre1
                    
#r "nuget: Grpc.Net.Client.Web, 2.52.0-pre1"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package Grpc.Net.Client.Web@2.52.0-pre1
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=Grpc.Net.Client.Web&version=2.52.0-pre1&prerelease
                    
Install as a Cake Addin
#tool nuget:?package=Grpc.Net.Client.Web&version=2.52.0-pre1&prerelease
                    
Install as a Cake Tool

Grpc.Net.Client.Web

The .NET gRPC client can be configured to make gRPC-Web calls. This is useful for Blazor WebAssembly apps, which are hosted in the browser and have the same HTTP limitations of JavaScript code. Calling gRPC-Web with a .NET client is the same as HTTP/2 gRPC. The only modification is how the channel is created.

To use gRPC-Web:

  • Add a reference to the Grpc.Net.Client.Web package.
  • Ensure the reference to Grpc.Net.Client package is 2.29.0 or greater.
  • Configure the channel to use the GrpcWebHandler:
var channel = GrpcChannel.ForAddress("https://localhost:5001", new GrpcChannelOptions
    {
        HttpHandler = new GrpcWebHandler(new HttpClientHandler())
    });

var client = new Greeter.GreeterClient(channel);
var response = await client.SayHelloAsync(new HelloRequest { Name = ".NET" });

The preceding code:

  • Configures a channel to use gRPC-Web.
  • Creates a client and makes a call using the channel.

GrpcWebHandler has the following configuration options:

  • InnerHandler: The underlying HttpMessageHandler that makes the gRPC HTTP request, for example, HttpClientHandler.
  • GrpcWebMode: An enumeration type that specifies whether the gRPC HTTP request Content-Type is application/grpc-web or application/grpc-web-text.
    • GrpcWebMode.GrpcWeb configures content to be sent without encoding. Default value.
    • GrpcWebMode.GrpcWebText configures content to be base64 encoded. Required for server streaming calls in browsers.
  • HttpVersion: HTTP protocol Version used to set HttpRequestMessage.Version on the underlying gRPC HTTP request. gRPC-Web doesn't require a specific version and doesn't override the default unless specified.

gRPC-Web and streaming

Traditional gRPC over HTTP/2 supports streaming in all directions. gRPC-Web offers limited support for streaming:

  • gRPC-Web browser clients don't support calling client streaming and bidirectional streaming methods.
  • gRPC-Web .NET clients don't support calling client streaming and bidirectional streaming methods over HTTP/1.1.
  • ASP.NET Core gRPC services hosted on Azure App Service and IIS don't support bidirectional streaming.

When using gRPC-Web, we only recommend the use of unary methods and server streaming methods.

Product Compatible and additional computed target framework versions.
.NET net5.0 is compatible.  net5.0-windows was computed.  net6.0 is compatible.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 is compatible.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 was computed.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed.  net9.0 was computed.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 was computed.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
.NET Core netcoreapp2.0 was computed.  netcoreapp2.1 was computed.  netcoreapp2.2 was computed.  netcoreapp3.0 was computed.  netcoreapp3.1 was computed. 
.NET Standard netstandard2.0 is compatible.  netstandard2.1 is compatible. 
.NET Framework net461 was computed.  net462 was computed.  net463 was computed.  net47 was computed.  net471 was computed.  net472 was computed.  net48 was computed.  net481 was computed. 
MonoAndroid monoandroid was computed. 
MonoMac monomac was computed. 
MonoTouch monotouch was computed. 
Tizen tizen40 was computed.  tizen60 was computed. 
Xamarin.iOS xamarinios was computed. 
Xamarin.Mac xamarinmac was computed. 
Xamarin.TVOS xamarintvos was computed. 
Xamarin.WatchOS xamarinwatchos was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.
  • .NETStandard 2.0

  • .NETStandard 2.1

    • No dependencies.
  • net5.0

    • No dependencies.
  • net6.0

    • No dependencies.
  • net7.0

    • No dependencies.

NuGet packages (47)

Showing the top 5 NuGet packages that depend on Grpc.Net.Client.Web:

Package Downloads
ArmoniK.Api.Client

Package Description

Sitko.Core.Grpc.Client

Sitko.Core is a set of libraries to help build .NET Core applications fast

IndependentReserve.Grpc

Basic types used by IndependentReserve.Grpc.Tools package This package contains .NET types which are referenced by gRPC code generated by `IndependentReserve.Grpc.Tools` package. This package might also need to be referenced by legacy .NET Framework projects which use gRPC code generated by `IndependentReserve.Grpc.Tools`. Newer .NET projects usually do not need to reference this package explicitly.

Toggly.FeatureManagement

Toggly.FeatureManagement extends Microsoft.FeatureManagement with extensions to handle feature state changes, Decorate and register services that are injected when a feature is on, feature usage tracking, and integration with toggly.io

M5x.Grpc

Package Description

GitHub repositories (13)

Showing the top 13 popular GitHub repositories that depend on Grpc.Net.Client.Web:

Repository Stars
dotnet/AspNetCore.Docs
Documentation for ASP.NET Core
dodyg/practical-aspnetcore
Practical samples of ASP.NET Core 10 Preview 5, 9, 8.0, 7.0, 6.0, 5.0, 3.1, 2.2, and 2.1,projects you can use. Readme contains explanations on all projects.
FastEndpoints/FastEndpoints
A light-weight REST API development framework for ASP.NET 8 and newer.
abpframework/abp-samples
Sample solutions built with the ABP Framework
mixcore/mix.core
🚀 A future-proof enterprise web CMS supporting both headless and decoupled approaches. Build any type of app with customizable APIs on ASP.NET Core/.NET Core. Completely open-source and designed for flexibility.
gustavnavar/Grid.Blazor
Grid component with CRUD for Blazor (client-side and server-side) and ASP.NET Core MVC
microsoft/RockPaperScissorsLizardSpock
Rock, Paper, Scissors, Lizard, Spock - Sample Application
havit/Havit.Blazor
Free Bootstrap 5 components for ASP.NET Blazor + optional enterprise-level stack for Blazor development (gRPC code-first, layered architecture, localization, auth, ...)
SteveSandersonMS/BlazeOrbital
Sample application for Blazor WebAssembly on .NET 6
chunliu/AzureDesignStudio
A web app that helps you create the architecture design diagram for your Azure solutions and automatically generate IaC code from it.
sitkoru/Sitko.Core
Sitko.Core is a set of libraries to help build .NET Core applications fast
anuviswan/LearningPoint
A repository for learning different technologies, frameworks, features......
Redth/Maui.UITesting
Experimenting with UI Testing approaches for .NET / MAUI
Version Downloads Last Updated
2.71.0 153,618 4/25/2025
2.71.0-pre1 713 4/16/2025
2.70.0 149,974 3/10/2025
2.70.0-pre1 256 2/26/2025
2.67.0 639,432 11/21/2024
2.67.0-pre1 987 10/22/2024
2.66.0 435,165 9/20/2024
2.66.0-pre1 1,423 9/6/2024
2.65.0 251,008 7/27/2024
2.65.0-pre1 243 7/20/2024
2.64.0 32,250 7/19/2024
2.64.0-pre1 179 7/15/2024
2.63.0 373,480 5/24/2024
2.63.0-pre1 385 5/8/2024
2.62.0 431,139 3/29/2024
2.62.0-pre1 507 3/8/2024
2.61.0 476,750 2/22/2024
2.61.0-pre1 605 2/8/2024
2.60.0 461,836 1/3/2024
2.60.0-pre1 2,245 12/14/2023
2.59.0 233,163 11/8/2023
2.59.0-pre1 333 10/27/2023
2.58.0 131,297 10/19/2023
2.58.0-pre1 372 10/9/2023
2.57.0 342,217 9/6/2023
2.57.0-pre1 281 8/31/2023
2.56.0 82,728 8/25/2023
2.56.0-pre2 291 8/16/2023
2.56.0-pre1 1,605 8/3/2023
2.55.0 313,353 7/4/2023
2.55.0-pre1 266 6/23/2023
2.54.0 131,887 6/15/2023
2.54.0-pre1 431 5/25/2023
2.53.0 222,736 5/5/2023
2.53.0-pre1 481 4/12/2023
2.52.0 514,453 3/15/2023
2.52.0-pre1 367 3/3/2023
2.51.0 511,168 1/2/2023
2.51.0-pre1 587 12/7/2022
2.50.0 282,882 11/17/2022
2.50.0-pre1 620 11/3/2022
2.49.0 439,855 9/26/2022
2.49.0-pre1 1,234 9/1/2022
2.48.0 239,082 8/24/2022
2.48.0-pre1 487 8/17/2022
2.47.0 277,824 7/3/2022
2.47.0-pre1 886 6/23/2022
2.46.0 190,993 5/13/2022
2.46.0-pre1 1,143 4/28/2022
2.45.0 177,863 4/19/2022
2.45.0-pre1 516 4/7/2022
2.44.0 122,380 3/17/2022
2.44.0-pre1 1,274 3/9/2022
2.43.0 197,341 2/25/2022
2.43.0-pre1 5,472 1/28/2022
2.42.0 146,008 1/19/2022
2.42.0-pre1 3,887 12/30/2021
2.41.0 180,099 12/7/2021
2.41.0-pre1 24,625 11/12/2021
2.40.0 1,323,512 10/5/2021
2.40.0-pre1 728 9/9/2021
2.39.0 238,807 8/18/2021
2.39.0-pre1 78,786 8/6/2021
2.38.0 249,083 6/11/2021
2.38.0-pre1 633 6/4/2021
2.37.0 107,126 4/20/2021
2.37.0-pre1 496 4/14/2021
2.36.0 44,010 3/17/2021
2.36.0-pre1 802 3/9/2021
2.35.0 51,062 2/4/2021
2.35.0-pre1 441 1/26/2021
2.34.0 89,248 12/11/2020
2.34.0-pre1 566 12/1/2020
2.33.1 51,885 10/28/2020
2.33.1-pre1 561 10/22/2020
2.32.0 8,856 10/5/2020
2.32.0-pre1 1,318 9/8/2020
2.31.0 21,422 8/14/2020
2.31.0-pre2 533 8/3/2020
2.30.0 17,135 7/16/2020
2.30.0-pre1 1,189 6/17/2020
2.29.0 28,067 5/27/2020
2.29.0-pre1 999 5/15/2020
2.28.0-pre2 7,349 3/11/2020
2.28.0-pre1 9,527 3/3/2020
2.27.0-pre1 6,863 1/24/2020