TypeValidationEventArgs.ReturnValue TypeValidationEventArgs.ReturnValue TypeValidationEventArgs.ReturnValue TypeValidationEventArgs.ReturnValue Property

定義

書式設定された入力文字列を変換した結果生成されたオブジェクトを取得します。Gets the object that results from the conversion of the formatted input string.

public:
 property System::Object ^ ReturnValue { System::Object ^ get(); };
public object ReturnValue { get; }
member this.ReturnValue : obj
Public ReadOnly Property ReturnValue As Object

プロパティ値

検証が正常に実行された場合は、型変換の結果を表す Object。それ以外の場合は nullIf the validation is successful, an Object that represents the converted type; otherwise, null.

このメンバーの使用例を次のコード例に示します。The following code example demonstrates the use of this member. この例では、イベントハンドラーがMaskedTextBox.TypeValidationCompletedイベントの発生を報告します。In the example, an event handler reports on the occurrence of the MaskedTextBox.TypeValidationCompleted event. このレポートは、イベントがいつ発生し、デバッグに役立つかを理解するのに役立ちます。This report helps you to learn when the event occurs and can assist you in debugging. 複数のイベントまたは頻繁に発生するイベントについてレポートMessageBox.ShowするConsole.WriteLineには、メッセージをに置き換えるTextBoxか、または複数行に追加することを検討してください。To report on multiple events or on events that occur frequently, consider replacing MessageBox.Show with Console.WriteLine or appending the message to a multiline TextBox.

コード例を実行するには、という名前MaskedTextBox MaskedTextBox1の型のインスタンスを含むプロジェクトに貼り付けます。To run the example code, paste it into a project that contains an instance of type MaskedTextBox named MaskedTextBox1. 次に、イベントハンドラーがMaskedTextBox.TypeValidationCompletedイベントに関連付けられていることを確認します。Then ensure that the event handler is associated with the MaskedTextBox.TypeValidationCompleted event.

private void MaskedTextBox1_TypeValidationCompleted(Object sender, TypeValidationEventArgs e) {

System.Text.StringBuilder messageBoxCS = new System.Text.StringBuilder();
messageBoxCS.AppendFormat("{0} = {1}", "Cancel", e.Cancel );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "IsValidInput", e.IsValidInput );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "Message", e.Message );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "ReturnValue", e.ReturnValue );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "ValidatingType", e.ValidatingType );
messageBoxCS.AppendLine();
MessageBox.Show(messageBoxCS.ToString(), "TypeValidationCompleted Event" );
}
Private Sub MaskedTextBox1_TypeValidationCompleted(sender as Object, e as TypeValidationEventArgs) _ 
     Handles MaskedTextBox1.TypeValidationCompleted

    Dim messageBoxVB as New System.Text.StringBuilder()
    messageBoxVB.AppendFormat("{0} = {1}", "Cancel", e.Cancel)
    messageBoxVB.AppendLine()
    messageBoxVB.AppendFormat("{0} = {1}", "IsValidInput", e.IsValidInput)
    messageBoxVB.AppendLine()
    messageBoxVB.AppendFormat("{0} = {1}", "Message", e.Message)
    messageBoxVB.AppendLine()
    messageBoxVB.AppendFormat("{0} = {1}", "ReturnValue", e.ReturnValue)
    messageBoxVB.AppendLine()
    messageBoxVB.AppendFormat("{0} = {1}", "ValidatingType", e.ValidatingType)
    messageBoxVB.AppendLine()
    MessageBox.Show(messageBoxVB.ToString(),"TypeValidationCompleted Event")

End Sub

注釈

型の検証プロセスは、プロンプト文字を含まない書式設定された入力文字列を、 ValidatingTypeプロパティで指定された型に変換しようとします。The type validation process attempts to convert the formatted input string, not including prompt characters, to the type specified by the ValidatingType property. プロパティReturnValueは変換試行の結果を表し、はMaskedTextBoxクラスのValidateTextメソッドによって返される値と同じです。The ReturnValue property represents the result of the conversion attempt, and is equivalent to the value returned by the ValidateText method of the MaskedTextBox class.

適用対象

こちらもご覧ください