指定したコントロールの現在のエラーを説明する文字列を返します。
Public Function GetError( _
ByVal control As Control _) As String
[C#]
public string GetError(Controlcontrol);
[C++]
public: String* GetError(Control* control);
[JScript]
public function GetError(
control : Control) : String;
パラメータ
- control
エラーを説明する文字列を取得する対象となる項目。
戻り値
指定したコントロールの現在のエラーを説明する文字列。
使用例
[Visual Basic, C#] TextBox1 オブジェクトのテキストを検証する方法を次のコード例に示します。この例では、ファイル ダイアログの InitialDirectory プロパティを TextBox1 のテキストに設定し、テキスト ボックスの LostFocus イベントも処理しています。このコード例では、 GetError メソッドを使用して、ファイル ダイアログを開く前にエラーがあるかどうかを調べます。この例を実行するには、TextBox1 という名前の TextBox、OpenFileDialog1 という名前の OpenFileDialog、Button1 という名前のボタン、および ErrorProvider1 という名前の ErrorProvider が配置されているフォームに、次のコードを貼り付けます。必ずこの例のすべてのイベントをイベント処理メソッドに関連付けるようにしてください。
Private Sub TextBox1_Validating(ByVal sender As Object, _
ByVal e As System.ComponentModel.CancelEventArgs) _
Handles TextBox1.Validating
' If nothing is entered,
' an ArgumentException is caught; if an invalid directory is entered,
' a DirectoryNotFoundException is caught. An appropriate error message
' is displayed in either case.
Try
Dim directory As New System.IO.DirectoryInfo(TextBox1.Text)
directory.GetFiles()
ErrorProvider1.SetError(TextBox1, "")
Catch ex1 As System.ArgumentException
ErrorProvider1.SetError(TextBox1, "Please enter a directory")
Catch ex2 As System.IO.DirectoryNotFoundException
ErrorProvider1.SetError(TextBox1, _
"The directory does not exist." & _
"Try again with a different directory.")
End Try
End Sub
' This method handles the LostFocus event for TextBox1 by setting the
' dialog's InitialDirectory property to the text in TextBox1.
Private Sub TextBox1_LostFocus(ByVal sender As Object, _
ByVal e As System.EventArgs) Handles TextBox1.LostFocus
OpenFileDialog1.InitialDirectory = TextBox1.Text
End Sub
' This method demonstrates using the ErrorProvider.GetError method
' to check for an error before opening the dialog box.
Private Sub Button1_Click(ByVal sender As System.Object, _
ByVal e As System.EventArgs) Handles Button1.Click
'If there is no error, then open the dialog box.
If ErrorProvider1.GetError(TextBox1) = "" Then
Dim dialogResult As DialogResult = OpenFileDialog1.ShowDialog()
End If
End Sub
[C#]
private void TextBox1_Validating(object sender,
System.ComponentModel.CancelEventArgs e)
{
// If nothing is entered,
// an ArgumentException is caught; if an invalid directory is entered,
// a DirectoryNotFoundException is caught. An appropriate error message
// is displayed in either case.
try
{
System.IO.DirectoryInfo directory =
new System.IO.DirectoryInfo(TextBox1.Text);
directory.GetFiles();
ErrorProvider1.SetError(TextBox1, "");
}
catch(System.ArgumentException ex1)
{
ErrorProvider1.SetError(TextBox1, "Please enter a directory");
}
catch(System.IO.DirectoryNotFoundException ex2)
{
ErrorProvider1.SetError(TextBox1, "The directory does not exist." +
"Try again with a different directory.");
}
}
// This method handles the LostFocus event for TextBox1 by setting the
// dialog's InitialDirectory property to the text in TextBox1.
private void TextBox1_LostFocus(object sender, System.EventArgs e)
{
OpenFileDialog1.InitialDirectory = TextBox1.Text;
}
// This method demonstrates using the ErrorProvider.GetError method
// to check for an error before opening the dialog box.
private void Button1_Click(System.Object sender, System.EventArgs e)
{
//If there is no error, then open the dialog box.
if (ErrorProvider1.GetError(TextBox1)=="")
{
DialogResult dialogResult = OpenFileDialog1.ShowDialog();
}
}
[C++, JScript] C++ および JScript のサンプルはありません。Visual Basic および C# のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン をクリックします。
必要条件
プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ
参照
ErrorProvider クラス | ErrorProvider メンバ | System.Windows.Forms 名前空間 | SetError