TextTranslationClient.Translate Método

Definição

Namespace:

Azure.AI.Translation.Text

Assembly:

Azure.AI.Translation.Text.dll

Pacote:

Azure.AI.Translation.Text v1.0.0-beta.1

Sobrecargas

Translate(String, IEnumerable<String>, String, CancellationToken)	Traduzir Texto.
Translate(String, String, String, CancellationToken)	Traduzir Texto.
Translate(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.

Translate(String, IEnumerable<String>, String, CancellationToken)

Traduzir Texto.

public virtual Azure.Response<System.Collections.Generic.IReadOnlyList<Azure.AI.Translation.Text.TranslatedTextItem>> Translate (string targetLanguage, System.Collections.Generic.IEnumerable<string> content, string sourceLanguage = default, System.Threading.CancellationToken cancellationToken = default);

abstract member Translate : string * seq<string> * string * System.Threading.CancellationToken -> Azure.Response<System.Collections.Generic.IReadOnlyList<Azure.AI.Translation.Text.TranslatedTextItem>>
override this.Translate : string * seq<string> * string * System.Threading.CancellationToken -> Azure.Response<System.Collections.Generic.IReadOnlyList<Azure.AI.Translation.Text.TranslatedTextItem>>

Public Overridable Function Translate (targetLanguage As String, content As IEnumerable(Of String), Optional sourceLanguage As String = Nothing, Optional cancellationToken As CancellationToken = Nothing) As 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

Response<IReadOnlyList<TranslatedTextItem>>

Exceções

ArgumentNullException

targetLanguage ou content é nulo.

Translate(String, String, String, CancellationToken)

Traduzir Texto.

public virtual Azure.Response<System.Collections.Generic.IReadOnlyList<Azure.AI.Translation.Text.TranslatedTextItem>> Translate (string targetLanguage, string text, string sourceLanguage = default, System.Threading.CancellationToken cancellationToken = default);

abstract member Translate : string * string * string * System.Threading.CancellationToken -> Azure.Response<System.Collections.Generic.IReadOnlyList<Azure.AI.Translation.Text.TranslatedTextItem>>
override this.Translate : string * string * string * System.Threading.CancellationToken -> Azure.Response<System.Collections.Generic.IReadOnlyList<Azure.AI.Translation.Text.TranslatedTextItem>>

Public Overridable Function Translate (targetLanguage As String, text As String, Optional sourceLanguage As String = Nothing, Optional cancellationToken As CancellationToken = Nothing) As 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

Response<IReadOnlyList<TranslatedTextItem>>

Exceções

ArgumentNullException

targetLanguage ou text é nulo.

Translate(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 Azure.Response<System.Collections.Generic.IReadOnlyList<Azure.AI.Translation.Text.TranslatedTextItem>> Translate (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 Translate : 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 -> Azure.Response<System.Collections.Generic.IReadOnlyList<Azure.AI.Translation.Text.TranslatedTextItem>>
override this.Translate : 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 -> Azure.Response<System.Collections.Generic.IReadOnlyList<Azure.AI.Translation.Text.TranslatedTextItem>>

Public Overridable Function Translate (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 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.

textType

Nullable<TextType>

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.

includeAlignment

Nullable<Boolean>

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).

includeSentenceLength

Nullable<Boolean>

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.

allowFallback

Nullable<Boolean>

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

Response<IReadOnlyList<TranslatedTextItem>>

Exceções

ArgumentNullException

targetLanguages ou content é nulo.