DataSourceView.ExecuteUpdate(IDictionary, IDictionary, IDictionary) 메서드
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
개체가 나타내는 데이터 DataSourceView 목록에서 업데이트 작업을 수행합니다.
protected:
virtual int ExecuteUpdate(System::Collections::IDictionary ^ keys, System::Collections::IDictionary ^ values, System::Collections::IDictionary ^ oldValues);
protected virtual int ExecuteUpdate(System.Collections.IDictionary keys, System.Collections.IDictionary values, System.Collections.IDictionary oldValues);
abstract member ExecuteUpdate : System.Collections.IDictionary * System.Collections.IDictionary * System.Collections.IDictionary -> int
override this.ExecuteUpdate : System.Collections.IDictionary * System.Collections.IDictionary * System.Collections.IDictionary -> int
Protected Overridable Function ExecuteUpdate (keys As IDictionary, values As IDictionary, oldValues As IDictionary) As Integer
매개 변수
- keys
- IDictionary
IDictionary 업데이트 작업으로 업데이트할 개체 또는 행 키입니다.
- values
- IDictionary
IDictionary 데이터 요소와 해당 새 값을 나타내는 이름/값 쌍입니다.
- oldValues
- IDictionary
IDictionary 데이터 요소와 원래 값을 나타내는 이름/값 쌍입니다.
반환
기본 데이터 스토리지에서 업데이트된 항목 수입니다.
예외
이 ExecuteUpdate(IDictionary, IDictionary, IDictionary) 작업은 .에서 DataSourceView지원되지 않습니다.
예제
다음 코드 예제에서는 클래스를 확장 DataSourceView 하는 클래스 속성 및 ExecuteUpdate 메서드를 재정의할 CanUpdate 수 있는 방법을 보여 줍니다. 이 코드 예제는 클래스에 제공된 더 큰 예제의 DataSourceView 일부입니다.
// The CsvDataSourceView does not currently
// permit update operations. You can modify or
// extend this sample to do so.
public override bool CanUpdate {
get {
return false;
}
}
protected override int ExecuteUpdate(IDictionary keys, IDictionary values, IDictionary oldValues)
{
throw new NotSupportedException();
}
' The CsvDataSourceView does not currently
' permit update operations. You can modify or
' extend this sample to do so.
Public Overrides ReadOnly Property CanUpdate() As Boolean
Get
Return False
End Get
End Property
Protected Overrides Function ExecuteUpdate(keys As IDictionary, _
values As IDictionary, _
oldValues As IDictionary) As Integer
Throw New NotSupportedException()
End Function 'ExecuteUpdate
End Class
설명
데이터 바인딩된 컨트롤은 메서드를 사용하여 DataSourceControl.GetView 개체를 검색 DataSourceView 하고 속성 값을 CanUpdate 확인하여 데이터 소스 컨트롤에서 작업을 지원하는지 여부를 ExecuteUpdate 확인할 수 있습니다.
매개 변수는 keys 업데이트할 데이터의 개체 또는 행 키를 나타냅니다. 컨트롤과 같은 관계형 데이터를 나타내는 데이터 원본의 SqlDataSourcekeys 경우 매개 변수는 데이터베이스 기본 키의 컬렉션입니다. 다른 시나리오 keys 에서 매개 변수는 이름/값 쌍의 컬렉션이며 데이터 목록을 필터링하는 데 사용됩니다. 이름/값 쌍과 일치하는 모든 데이터는 기존 필드 또는 열에 대한 새 값을 values 나타내는 이름/값 쌍 집합인 매개 변수에 있는 값으로 업데이트됩니다.
메모
DataSourceView 클래스의 기본 구현은 예외를 throw하는 것입니다NotSupportedException. 클래스를 DataSourceView 확장하는 경우 클래스가 ExecuteUpdate 기본 데이터 스토리지의 데이터 업데이트를 지원하는 경우 메서드를 재정의합니다.