DataGridView.RowErrorTextNeeded DataGridView.RowErrorTextNeeded DataGridView.RowErrorTextNeeded DataGridView.RowErrorTextNeeded Event

정의

행의 오류 텍스트가 필요한 경우 발생합니다.Occurs when a row's error text is needed.

public:
 event System::Windows::Forms::DataGridViewRowErrorTextNeededEventHandler ^ RowErrorTextNeeded;
public event System.Windows.Forms.DataGridViewRowErrorTextNeededEventHandler RowErrorTextNeeded;
member this.RowErrorTextNeeded : System.Windows.Forms.DataGridViewRowErrorTextNeededEventHandler 
Public Custom Event RowErrorTextNeeded As DataGridViewRowErrorTextNeededEventHandler 

예제

다음 코드 예제에서는이 멤버를 사용 하는 방법을 보여 줍니다.The following code example demonstrates the use of this member. 예제에서는 이벤트 처리기에서 보고서를 RowErrorTextNeeded 이벤트입니다.In the example, an event handler reports on the occurrence of the RowErrorTextNeeded 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.

예제 코드를 실행 하려면 형식의 인스턴스를 포함 하는 프로젝트에 붙여넣습니다 DataGridView 라는 DataGridView1합니다.To run the example code, paste it into a project that contains an instance of type DataGridView named DataGridView1. 연결 된 이벤트 처리기는 확인 된 RowErrorTextNeeded 이벤트입니다.Then ensure that the event handler is associated with the RowErrorTextNeeded event.

private void DataGridView1_RowErrorTextNeeded(Object sender, DataGridViewRowErrorTextNeededEventArgs e) {

System.Text.StringBuilder messageBoxCS = new System.Text.StringBuilder();
messageBoxCS.AppendFormat("{0} = {1}", "ErrorText", e.ErrorText );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "RowIndex", e.RowIndex );
messageBoxCS.AppendLine();
MessageBox.Show(messageBoxCS.ToString(), "RowErrorTextNeeded Event" );
}
Private Sub DataGridView1_RowErrorTextNeeded(sender as Object, e as DataGridViewRowErrorTextNeededEventArgs) _ 
     Handles DataGridView1.RowErrorTextNeeded

    Dim messageBoxVB as New System.Text.StringBuilder()
    messageBoxVB.AppendFormat("{0} = {1}", "ErrorText", e.ErrorText)
    messageBoxVB.AppendLine()
    messageBoxVB.AppendFormat("{0} = {1}", "RowIndex", e.RowIndex)
    messageBoxVB.AppendLine()
    MessageBox.Show(messageBoxVB.ToString(),"RowErrorTextNeeded Event")

End Sub

설명

RowErrorTextNeeded 이벤트에만 발생 경우를 DataSource 의 속성을 DataGridView 설정 되어 또는 해당 VirtualMode 속성이 true.The RowErrorTextNeeded event occurs only when the DataSource property of the DataGridView control is set or its VirtualMode property is true. 처리는 RowErrorTextNeeded 이벤트는 해당 상태와 포함 된 값에 따라 행 오류 정보에서 확인 하려는 경우에 유용 합니다.Handling the RowErrorTextNeeded event is useful when you want to determine the error for a row depending on its state and the values it contains.

처리 하는 경우는 RowErrorTextNeeded 이벤트 오류 텍스트에에서 지정 된 처리기를 행 머리글에 오류 문자 모양과 표시 하지 않는 한는 ShowRowErrors 속성이 false합니다.When you handle the RowErrorTextNeeded event and specify error text in the handler, an error glyph appears in the row header unless the ShowRowErrors property is set to false. 오류 기호 위로 마우스 포인터를 이동할 때 오류 텍스트 도구 설명에 나타납니다.When the user moves the mouse pointer over the error glyph, the error text appears in a ToolTip.

RowErrorTextNeeded 이벤트도 발생 될 때마다 값을 DataGridViewRow.ErrorText 속성을 검색 합니다.The RowErrorTextNeeded event also occurs whenever the value of the DataGridViewRow.ErrorText property is retrieved.

사용할 수는 DataGridViewRowErrorTextNeededEventArgs.RowIndex 속성을 행 또는 포함 된 값의 상태를 확인 하 고이 정보를 사용 하 여 변경 하거나 수정 하는 DataGridViewRowErrorTextNeededEventArgs.ErrorText 속성입니다.You can use the DataGridViewRowErrorTextNeededEventArgs.RowIndex property to determine the state of a row or the values it contains, and use this information to change or modify the DataGridViewRowErrorTextNeededEventArgs.ErrorText property. 이 속성은 행의 값을 사용 하 여 초기화 ErrorText 이벤트 값을 재정의 하는 속성입니다.This property is initialized with the value of the row ErrorText property, which the event value overrides.

처리를 RowErrorTextNeeded 대량의 행을 설정 하는 성능 저하를 방지 하려면 데이터를 작업할 때 이벤트 ErrorText 여러 행에 대 한 값입니다.Handle the RowErrorTextNeeded event when working with large amounts of data to avoid the performance penalties of setting the row ErrorText value for multiple rows. 자세한 내용은 Windows Forms DataGridView 컨트롤의 크기 조정에 대 한 모범 사례합니다.For more information, see Best Practices for Scaling the Windows Forms DataGridView Control.

이벤트를 처리 하는 방법에 대 한 자세한 내용은 참조 하세요. 이벤트 처리 및 발생합니다.For more information about how to handle events, see Handling and Raising Events.

적용 대상

추가 정보