Compartilhar via


DataRequest.FailWithDisplayText(String) Método

Definição

Cancela a operação de compartilhamento e fornece uma cadeia de caracteres de erro a ser exibida ao usuário.

public:
 virtual void FailWithDisplayText(Platform::String ^ value) = FailWithDisplayText;
void FailWithDisplayText(winrt::hstring const& value);
/// [Windows.Foundation.Metadata.Deprecated("FailWithDisplayText is deprecated and might not work on all platforms. For more info, see MSDN.", Windows.Foundation.Metadata.DeprecationType.Deprecate, 131072, "Windows.Foundation.UniversalApiContract")]
void FailWithDisplayText(winrt::hstring const& value);
public void FailWithDisplayText(string value);
[Windows.Foundation.Metadata.Deprecated("FailWithDisplayText is deprecated and might not work on all platforms. For more info, see MSDN.", Windows.Foundation.Metadata.DeprecationType.Deprecate, 131072, "Windows.Foundation.UniversalApiContract")]
public void FailWithDisplayText(string value);
function failWithDisplayText(value)
Public Sub FailWithDisplayText (value As String)

Parâmetros

value
String

Platform::String

winrt::hstring

O texto a ser exibido ao usuário.

Atributos

Comentários

Use o método FailWithDisplayText quando seu aplicativo não puder fornecer um DataPackage a um aplicativo de destino. Esse método cancela a operação de compartilhamento e fornece uma mensagem de texto para o aplicativo de destino. Em seguida, o aplicativo de destino pode exibir esse texto para o usuário para explicar por que a operação de compartilhamento falhou.

Essa API foi marcada como preterida nas versões 1511 e 1607 do SDK. No entanto, essa API não é mais preterida a partir de 1703. Você pode suprimir o aviso de substituição no Visual Studio seguindo as instruções no tópico Como suprimir avisos do compilador .

Aplica-se a