TextTranslationClient.TranslateAsync Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Sobrecargas
TranslateAsync(String, IEnumerable<String>, String, CancellationToken)
Traduzir Texto.
public virtual System.Threading.Tasks.Task<Azure.Response<System.Collections.Generic.IReadOnlyList<Azure.AI.Translation.Text.TranslatedTextItem>>> TranslateAsync (string targetLanguage, System.Collections.Generic.IEnumerable<string> content, string sourceLanguage = default, System.Threading.CancellationToken cancellationToken = default);abstract member TranslateAsync : string * seq<string> * string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response<System.Collections.Generic.IReadOnlyList<Azure.AI.Translation.Text.TranslatedTextItem>>>
override this.TranslateAsync : string * seq<string> * string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response<System.Collections.Generic.IReadOnlyList<Azure.AI.Translation.Text.TranslatedTextItem>>>Public Overridable Function TranslateAsync (targetLanguage As String, content As IEnumerable(Of String), Optional sourceLanguage As String = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of Response(Of IReadOnlyList(Of TranslatedTextItem)))Parâmetros
- targetLanguage
- String
Especifica o idioma do texto de saída. O idioma de destino deve ser um dos idiomas com suporte incluídos no escopo de tradução. Por exemplo, use to=de para traduzir para alemão. É possível traduzir para vários idiomas simultaneamente, repetindo o parâmetro na cadeia de caracteres de consulta. Por exemplo, use to=de&to=it para traduzir para alemão e italiano.
- content
- IEnumerable<String>
Matriz do texto a ser traduzido.
- sourceLanguage
- String
Especifica o idioma do texto de entrada. Localize quais idiomas estão disponíveis para tradução pesquisando idiomas com suporte usando o escopo de tradução. Se o parâmetro from não for especificado, a detecção automática de idioma será aplicada para determinar o idioma de origem.
Você deve usar o parâmetro from em vez de autodetecção ao usar o recurso de dicionário dinâmico. Observação: o recurso de dicionário dinâmico diferencia maiúsculas de minúsculas.
- cancellationToken
- CancellationToken
O token de cancelamento a ser usado.
Retornos
Exceções
targetLanguage ou content é nulo.
Aplica-se a
TranslateAsync(String, String, String, CancellationToken)
Traduzir Texto.
public virtual System.Threading.Tasks.Task<Azure.Response<System.Collections.Generic.IReadOnlyList<Azure.AI.Translation.Text.TranslatedTextItem>>> TranslateAsync (string targetLanguage, string text, string sourceLanguage = default, System.Threading.CancellationToken cancellationToken = default);abstract member TranslateAsync : string * string * string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response<System.Collections.Generic.IReadOnlyList<Azure.AI.Translation.Text.TranslatedTextItem>>>
override this.TranslateAsync : string * string * string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response<System.Collections.Generic.IReadOnlyList<Azure.AI.Translation.Text.TranslatedTextItem>>>Public Overridable Function TranslateAsync (targetLanguage As String, text As String, Optional sourceLanguage As String = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of Response(Of IReadOnlyList(Of TranslatedTextItem)))Parâmetros
- targetLanguage
- String
Especifica o idioma do texto de saída. O idioma de destino deve ser um dos idiomas com suporte incluídos no escopo de tradução. Por exemplo, use to=de para traduzir para alemão. É possível traduzir para vários idiomas simultaneamente, repetindo o parâmetro na cadeia de caracteres de consulta. Por exemplo, use to=de&to=it para traduzir para alemão e italiano.
- text
- String
Texto a ser traduzido.
- sourceLanguage
- String
Especifica o idioma do texto de entrada. Localize quais idiomas estão disponíveis para tradução pesquisando idiomas com suporte usando o escopo de tradução. Se o parâmetro from não for especificado, a detecção automática de idioma será aplicada para determinar o idioma de origem.
Você deve usar o parâmetro from em vez de autodetecção ao usar o recurso de dicionário dinâmico. Observação: o recurso de dicionário dinâmico diferencia maiúsculas de minúsculas.
- cancellationToken
- CancellationToken
O token de cancelamento a ser usado.
Retornos
Exceções
targetLanguage ou text é nulo.
Aplica-se a
TranslateAsync(IEnumerable<String>, IEnumerable<String>, String, String, Nullable<TextType>, String, Nullable<ProfanityAction>, Nullable<ProfanityMarker>, Nullable<Boolean>, Nullable<Boolean>, String, String, String, Nullable<Boolean>, CancellationToken)
Traduzir Texto.
public virtual System.Threading.Tasks.Task<Azure.Response<System.Collections.Generic.IReadOnlyList<Azure.AI.Translation.Text.TranslatedTextItem>>> TranslateAsync (System.Collections.Generic.IEnumerable<string> targetLanguages, System.Collections.Generic.IEnumerable<string> content, string clientTraceId = default, string sourceLanguage = default, Azure.AI.Translation.Text.TextType? textType = default, string category = default, Azure.AI.Translation.Text.ProfanityAction? profanityAction = default, Azure.AI.Translation.Text.ProfanityMarker? profanityMarker = default, bool? includeAlignment = default, bool? includeSentenceLength = default, string suggestedFrom = default, string fromScript = default, string toScript = default, bool? allowFallback = default, System.Threading.CancellationToken cancellationToken = default);abstract member TranslateAsync : seq<string> * seq<string> * string * string * Nullable<Azure.AI.Translation.Text.TextType> * string * Nullable<Azure.AI.Translation.Text.ProfanityAction> * Nullable<Azure.AI.Translation.Text.ProfanityMarker> * Nullable<bool> * Nullable<bool> * string * string * string * Nullable<bool> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response<System.Collections.Generic.IReadOnlyList<Azure.AI.Translation.Text.TranslatedTextItem>>>
override this.TranslateAsync : seq<string> * seq<string> * string * string * Nullable<Azure.AI.Translation.Text.TextType> * string * Nullable<Azure.AI.Translation.Text.ProfanityAction> * Nullable<Azure.AI.Translation.Text.ProfanityMarker> * Nullable<bool> * Nullable<bool> * string * string * string * Nullable<bool> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response<System.Collections.Generic.IReadOnlyList<Azure.AI.Translation.Text.TranslatedTextItem>>>Public Overridable Function TranslateAsync (targetLanguages As IEnumerable(Of String), content As IEnumerable(Of String), Optional clientTraceId As String = Nothing, Optional sourceLanguage As String = Nothing, Optional textType As Nullable(Of TextType) = Nothing, Optional category As String = Nothing, Optional profanityAction As Nullable(Of ProfanityAction) = Nothing, Optional profanityMarker As Nullable(Of ProfanityMarker) = Nothing, Optional includeAlignment As Nullable(Of Boolean) = Nothing, Optional includeSentenceLength As Nullable(Of Boolean) = Nothing, Optional suggestedFrom As String = Nothing, Optional fromScript As String = Nothing, Optional toScript As String = Nothing, Optional allowFallback As Nullable(Of Boolean) = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of Response(Of IReadOnlyList(Of TranslatedTextItem)))Parâmetros
- targetLanguages
- IEnumerable<String>
Especifica o idioma do texto de saída. O idioma de destino deve ser um dos idiomas com suporte incluídos no escopo de tradução. Por exemplo, use to=de para traduzir para alemão. É possível traduzir para vários idiomas simultaneamente, repetindo o parâmetro na cadeia de caracteres de consulta. Por exemplo, use to=de&to=it para traduzir para alemão e italiano.
- content
- IEnumerable<String>
Matriz do texto a ser traduzido.
- clientTraceId
- String
Um GUID gerado pelo cliente para identificar exclusivamente a solicitação.
- sourceLanguage
- String
Especifica o idioma do texto de entrada. Localize quais idiomas estão disponíveis para tradução pesquisando idiomas com suporte usando o escopo de tradução. Se o parâmetro from não for especificado, a detecção automática de idioma será aplicada para determinar o idioma de origem.
Você deve usar o parâmetro from em vez de autodetecção ao usar o recurso de dicionário dinâmico. Observação: o recurso de dicionário dinâmico diferencia maiúsculas de minúsculas.
Define se o texto que está sendo traduzido é texto sem formatação ou texto HTML. Qualquer HTML precisa ser um elemento bem formado e completo. Os valores possíveis são: simples (padrão) ou html.
- category
- String
Uma cadeia de caracteres especificando a categoria (domínio) da tradução. Esse parâmetro é usado para obter traduções de um sistema personalizado compilado com Tradutor Personalizado. Adicione a ID da categoria dos detalhes de seu projeto de Tradutor Personalizado a esse parâmetro para usar o sistema personalizado implantado. O valor padrão é: geral.
- profanityAction
- Nullable<ProfanityAction>
Especifica como os conteúdos ofensivos devem ser tratados nas traduções. Os valores possíveis são: NoAction (padrão), Marcado ou Excluído.
- profanityMarker
- Nullable<ProfanityMarker>
Especifica como os conteúdos ofensivos devem ser marcados nas traduções. Os valores possíveis são: Asterisco (padrão) ou Marca.
Especifica se deve incluir a projeção de alinhamento do texto de origem para texto traduzido. Os valores possíveis são: true ou false (padrão).
Especifica se deve incluir limites de sentença para o texto de entrada e o texto traduzido. Os valores possíveis são: true ou false (padrão).
- suggestedFrom
- String
Especifica um idioma de fallback se o idioma do texto de entrada não pode ser identificado. A autodeteção de linguagem é aplicada quando o parâmetro from é omitido. Se a detecção falhar, a linguagem suggestedFrom será assumida.
- fromScript
- String
Especifica o script do texto de entrada.
- toScript
- String
Especifica o script do texto traduzido.
Especifica que o serviço tem permissão para fazer fallback para um sistema geral quando um sistema personalizado não existe. Os valores possíveis são: true (padrão) ou false.
allowFallback=false especifica que a tradução só deve usar sistemas treinados para a categoria especificada pela solicitação. Se uma tradução do idioma X para a o idioma Y requer encadeamento por meio de um idioma dinâmico E, todos os sistemas da cadeia (X → E and E → Y) precisarão ser personalizados e ter a mesma categoria. Se nenhum sistema for encontrado com a categoria específica, a solicitação retornará um código de 400 status. allowFallback=true especifica que o serviço tem permissão para fazer fallback para um sistema geral quando um sistema personalizado não existe.
- cancellationToken
- CancellationToken
O token de cancelamento a ser usado.
Retornos
Exceções
targetLanguages ou content é nulo.
Aplica-se a
Azure SDK for .NET