WebPubSubServiceClient.SendToGroup Método

Definição

Namespace:

Azure.Messaging.WebPubSub

Assembly:

Azure.Messaging.WebPubSub.dll

Pacote:

Azure.Messaging.WebPubSub v1.3.0

Sobrecargas

SendToGroup(String, String, ContentType)	Enviar mensagem para um grupo de conexões.
SendToGroup(String, RequestContent, ContentType, IEnumerable<String>, RequestContext)	Enviar conteúdo dentro do corpo da solicitação para um grupo de conexões.
SendToGroup(String, RequestContent, ContentType, IEnumerable<String>, String, RequestContext)	Enviar conteúdo dentro do corpo da solicitação para um grupo de conexões.

SendToGroup(String, String, ContentType)

Origem:

WebPubSubServiceClient_extensions.cs

Enviar mensagem para um grupo de conexões.

public virtual Azure.Response SendToGroup (string group, string content, Azure.Core.ContentType contentType = default);

abstract member SendToGroup : string * string * Azure.Core.ContentType -> Azure.Response
override this.SendToGroup : string * string * Azure.Core.ContentType -> Azure.Response

Public Overridable Function SendToGroup (group As String, content As String, Optional contentType As ContentType = Nothing) As Response

Parâmetros

group

String

Nome do grupo de destino, cujo comprimento deve ser maior que 0 e menor que 1025.

content

String

contentType

ContentType

O padrão é ContentType.PlainText.

Retornos

Response

Um Response se bem-sucedido.

SendToGroup(String, RequestContent, ContentType, IEnumerable<String>, RequestContext)

Origem:

WebPubSubServiceClient.cs

Enviar conteúdo dentro do corpo da solicitação para um grupo de conexões.

public virtual Azure.Response SendToGroup (string group, Azure.Core.RequestContent content, Azure.Core.ContentType contentType, System.Collections.Generic.IEnumerable<string> excluded, Azure.RequestContext context);

abstract member SendToGroup : string * Azure.Core.RequestContent * Azure.Core.ContentType * seq<string> * Azure.RequestContext -> Azure.Response
override this.SendToGroup : string * Azure.Core.RequestContent * Azure.Core.ContentType * seq<string> * Azure.RequestContext -> Azure.Response

Public Overridable Function SendToGroup (group As String, content As RequestContent, contentType As ContentType, excluded As IEnumerable(Of String), context As RequestContext) As Response

Parâmetros

group

String

Nome do grupo de destino, cujo comprimento deve ser maior que 0 e menor que 1025.

content

RequestContent

O conteúdo a ser enviado como o corpo da solicitação. Os detalhes do esquema do corpo da solicitação estão na seção Comentários abaixo.

contentType

ContentType

Tipo de arquivo de upload. Valores permitidos: "application/json" | "application/octet-stream" | "text/plain".

excluded

IEnumerable<String>

IDs de conexão excluídas.

context

RequestContext

O contexto de solicitação, que pode substituir os comportamentos padrão do pipeline do cliente por chamada.

Retornos

Response

A resposta retornada do serviço.

Exceções

ArgumentNullException

group ou content é nulo.

ArgumentException

group é uma cadeia de caracteres vazia e esperava-se que não estivesse vazia.

RequestFailedException

O serviço retornou um código de status sem êxito.

Exemplos

Este exemplo mostra como chamar SendToGroup com os parâmetros necessários e o conteúdo da solicitação.

var client = new WebPubSubServiceClient("<https://my-service.azure.com>", "<hub>");

var data = File.OpenRead("<filePath>");

Response response = client.SendToGroup("<group>", RequestContent.Create(data), ContentType.ApplicationOctetStream);
Console.WriteLine(response.Status);

Este exemplo mostra como chamar SendToGroup com todos os parâmetros e conteúdo da solicitação.

var client = new WebPubSubServiceClient("<https://my-service.azure.com>", "<hub>");

var data = File.OpenRead("<filePath>");

Response response = client.SendToGroup("<group>", RequestContent.Create(data), ContentType.ApplicationOctetStream, new String[]{"<excluded>"});
Console.WriteLine(response.Status);

Comentários

Esquema para Response Error:

{
              code: string,
              message: string,
              target: string,
              details: [ErrorDetail],
              inner: {
                code: string,
                inner: InnerError
              }
            }

SendToGroup(String, RequestContent, ContentType, IEnumerable<String>, String, RequestContext)

Origem:

WebPubSubServiceClient.cs

Enviar conteúdo dentro do corpo da solicitação para um grupo de conexões.

public virtual Azure.Response SendToGroup (string group, Azure.Core.RequestContent content, Azure.Core.ContentType contentType, System.Collections.Generic.IEnumerable<string> excluded = default, string filter = default, Azure.RequestContext context = default);

abstract member SendToGroup : string * Azure.Core.RequestContent * Azure.Core.ContentType * seq<string> * string * Azure.RequestContext -> Azure.Response
override this.SendToGroup : string * Azure.Core.RequestContent * Azure.Core.ContentType * seq<string> * string * Azure.RequestContext -> Azure.Response

Public Overridable Function SendToGroup (group As String, content As RequestContent, contentType As ContentType, Optional excluded As IEnumerable(Of String) = Nothing, Optional filter As String = Nothing, Optional context As RequestContext = Nothing) As Response

Parâmetros

group

String

Nome do grupo de destino, cujo comprimento deve ser maior que 0 e menor que 1025.

content

RequestContent

O conteúdo a ser enviado como o corpo da solicitação. Os detalhes do esquema do corpo da solicitação estão na seção Comentários abaixo.

contentType

ContentType

Tipo de arquivo de upload. Valores permitidos: "application/json" | "application/octet-stream" | "text/plain".

excluded

IEnumerable<String>

IDs de conexão excluídas.

filter

String

Seguindo a sintaxe de filtro OData para filtrar os assinantes que recebem as mensagens.

context

RequestContext

O contexto de solicitação, que pode substituir os comportamentos padrão do pipeline do cliente por chamada.

Retornos

Response

A resposta retornada do serviço.

Exceções

ArgumentNullException

group ou content é nulo.

ArgumentException

group é uma cadeia de caracteres vazia e esperava-se que não estivesse vazia.

RequestFailedException

O serviço retornou um código de status sem êxito.

Exemplos

Este exemplo mostra como chamar SendToGroup com os parâmetros necessários e o conteúdo da solicitação.

var client = new WebPubSubServiceClient("<https://my-service.azure.com>", "<hub>");

var data = File.OpenRead("<filePath>");

Response response = client.SendToGroup("<group>", RequestContent.Create(data), ContentType.ApplicationOctetStream);
Console.WriteLine(response.Status);

Este exemplo mostra como chamar SendToGroup com todos os parâmetros e conteúdo da solicitação.

var client = new WebPubSubServiceClient("<https://my-service.azure.com>", "<hub>");

var data = File.OpenRead("<filePath>");

Response response = client.SendToGroup("<group>", RequestContent.Create(data), ContentType.ApplicationOctetStream, new String[]{"<excluded>"}, "<filter>");
Console.WriteLine(response.Status);