내보내기(0) 인쇄
모두 확장

SqlDataSourceView.ExecuteUpdate 메서드

참고: 이 메서드는 .NET Framework 버전 2.0에서 새로 추가되었습니다.

UpdateCommand SQL 문자열, UpdateParameters 컬렉션에 지정된 매개 변수, 지정된 keys, valuesoldValues 컬렉션의 값을 사용하여 업데이트 작업을 수행합니다.

네임스페이스: System.Web.UI.WebControls
어셈블리: System.Web(system.web.dll)

protected override int ExecuteUpdate (
	IDictionary keys,
	IDictionary values,
	IDictionary oldValues
)
protected int ExecuteUpdate (
	IDictionary keys, 
	IDictionary values, 
	IDictionary oldValues
)
protected override function ExecuteUpdate (
	keys : IDictionary, 
	values : IDictionary, 
	oldValues : IDictionary
) : int

매개 변수

keys

업데이트 데이터베이스 작업을 수행하기 위해 UpdateCommand 속성과 함께 사용할 기본 키의 IDictionary입니다. 쿼리에 연결된 키가 없거나 UpdateCommand 속성이 매개 변수가 있는 SQL 쿼리가 아닌 경우 Null 참조(Visual Basic의 경우 Nothing)을 전달합니다.

values

업데이트 데이터베이스 작업을 수행하기 위해 UpdateCommand 속성과 함께 사용할 값의 IDictionary입니다. 쿼리에 연결된 매개 변수가 없거나 UpdateCommand가 매개 변수가 있는 SQL 쿼리가 아닌 경우 Null 참조(Visual Basic의 경우 Nothing)을 전달합니다.

oldValues

데이터베이스의 원래 값을 나타내는 IDictionary입니다. 쿼리에 연결된 매개 변수가 없거나 UpdateCommand 속성이 매개 변수가 있는 SQL 쿼리가 아닌 경우 Null 참조(Visual Basic의 경우 Nothing)을 전달합니다.

반환 값

내부 데이터베이스에서 업데이트되는 행 수를 나타내는 값입니다.

예외 형식조건

InvalidOperationException

SqlDataSource가 내부 데이터 소스와 연결될 수 없는 경우

- 또는 -

ConflictDetection 속성이 CompareAllValues 값으로 설정되고 전달된 oldValues 매개 변수가 없는 경우

HttpException

현재 사용자에게 데이터베이스에 액세스할 수 있는 올바른 권한이 없는 경우

NotSupportedException

CanUpdate 속성이 false인 경우

SqlDataSourceView 클래스는 데이터베이스의 데이터를 업데이트하도록 상속된 ExecuteUpdate 메서드를 구현합니다. 페이지 개발자와 데이터 바인딩된 컨트롤 작성자는 ExecuteUpdate 메서드를 직접 호출하지 않고 공개적으로 노출된 Update 메서드를 사용합니다.

keysvalues 컬렉션에 포함된 값은 계산된후 UpdateParameters 컬렉션에 포함된 값과 병합됩니다. ConflictDetection 속성을 CompareAllValues로 설정한 경우 oldValues 컬렉션에 포함된 값은 OldValuesParameterFormatString을 사용하여 형식이 지정되고 병합됩니다.

업데이트 작업을 수행하기 전에 OnUpdating 메서드가 호출되어 Updating 이벤트가 발생합니다. 이 이벤트를 처리하여 매개 변수의 값을 확인하고 업데이트 작업 이전에 모든 전처리를 수행할 수 있습니다.

작업을 수행하기 위해 SqlDataSourceViewUpdateCommand 텍스트 및 연결된 UpdateParameters 속성을 사용하여 DbCommand 개체를 만든 다음 내부 데이터베이스에 대해 DbCommand 개체를 실행합니다. 작업이 완료되면 OnUpdated 메서드가 호출되면서 Updated 이벤트가 발생합니다. 이 이벤트를 처리하여 모든 반환 값과 오류 코드를 검사한 다음 후처리를 수행할 수 있습니다.

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework에서 모든 플래폼의 모든 버전을 지원하지는 않습니다. 지원되는 버전의 목록은 시스템 요구 사항을 참조하십시오.

.NET Framework

2.0에서 지원

커뮤니티 추가 항목

추가
표시:
© 2014 Microsoft