ListViewInsertedEventArgs.AffectedRows 속성

정의

삽입 작업이 적용되는 행의 수를 가져옵니다.

public:
 property int AffectedRows { int get(); };
public int AffectedRows { get; }
member this.AffectedRows : int
Public ReadOnly Property AffectedRows As Integer

속성 값

삽입 작업이 적용되는 행의 수입니다.

예제

다음 예제에서는 사용 하는 방법을 보여 줍니다 합니다 ListViewInsertedEventArgs 에 대 한 처리기에 전달 되는 개체는 ItemInserted 삽입 작업 중에 예외가 발생 했는지 여부를 결정 하는 이벤트입니다. 이 코드 예제는에 대해 제공 된 큰 예제의 일부는 ListViewInsertedEventArgs 클래스입니다.

void ContactsListView_ItemInserted(Object sender, ListViewInsertedEventArgs e)
{
  if (e.Exception != null)
  {
    if (e.AffectedRows == 0)
    {
      e.KeepInInsertMode = true;
      Message.Text = "An exception occurred inserting the new Contact. " +
        "Please verify your values and try again.";
    }
    else
      Message.Text = "An exception occurred inserting the new Contact. " +
        "Please verify the values in the newly inserted item.";

    e.ExceptionHandled = true;
  }
}
Sub ContactsListView_ItemInserted(ByVal sender As Object, ByVal e As ListViewInsertedEventArgs)

  If e.Exception IsNot Nothing Then

    If e.AffectedRows = 0 Then
      e.KeepInInsertMode = True
      Message.Text = "An exception occurred inserting the new Contact. " & _
        "Please verify your values and try again."
    Else
      Message.Text = "An exception occurred inserting the new Contact. " & _
        "Please verify the values in the newly inserted item."
    End If

    e.ExceptionHandled = True
  End If
End Sub

설명

사용 하 여는 AffectedRows 속성을 데이터 소스 컨트롤에서 반환 된 삽입 작업에 의해 영향을 받는 레코드 수를 결정 합니다. 이 속성은 다음과 같은 시나리오에서 일반적으로 사용 됩니다.

  • 에 단일 레코드만 삽입 되었는지 확인 합니다. 때로는 잘못 작성된 된 insert 문을 여러 레코드 삽입 수 있습니다.

  • 레코드 삽입 작업 중 오류가 발생 했지만 예외가 발생 하지 않았던 때문에 삽입 되지 않았음을 확인 합니다.

  • 레코드 충돌 검색 (낙관적 동시성)을 지 원하는 데이터 소스 컨트롤에 삽입 되었는지 확인 하려면 해당 ConflictDetection 속성이로 설정 된 ConflictOptions.CompareAllValues 열거형 값입니다. 이 속성을 지 원하는 컨트롤에 포함 된 SqlDataSourceObjectDataSource 컨트롤입니다. 속성에이 값이 다른 사용자에 의해 삽입 된 레코드와 같은 키 값이 있을 경우 레코드를 삽입 하지 않을 수 있습니다.

적용 대상

추가 정보