DbDataAdapter.UpdateBatchSize 속성 (System.Data.Common)

UpdateBatchSize 속성

저대역폭 보기 설정

모두 축소

언어 필터

이 페이지에서 다루는 특정 제품:.

Microsoft Visual Studio 2008/.NET Framework 3.5

다음 제품들은 다른 버전에서 다루어 집니다.

.NET Framework 클래스 라이브러리

DbDataAdapter..::.UpdateBatchSize 속성

업데이트: 2007년 11월

일괄 처리를 지원하거나 지원하지 않도록 설정하는 값을 가져오거나 설정하고 일괄적으로 실행될 수 있는 명령 수를 지정합니다.

네임스페이스: System.Data.Common
어셈블리: System.Data(System.Data.dll)

구문

Visual Basic(선언)

Public Overridable Property UpdateBatchSize As Integer

Visual Basic (사용법)

Dim instance As DbDataAdapter
Dim value As Integer

value = instance.UpdateBatchSize

instance.UpdateBatchSize = value

public virtual int UpdateBatchSize { get; set; }

Visual C++

public:
virtual property int UpdateBatchSize {
    int get ();
    void set (int value);
}

/** @property */
public int get_UpdateBatchSize()
/** @property */
public  void set_UpdateBatchSize(int value)

JScript

public function get UpdateBatchSize () : int
public function set UpdateBatchSize (value : int)

속성 값

형식: System..::.Int32
일괄 작업 당 처리할 행 수입니다.

값	효과
0	일괄 처리 크기에 제한이 없습니다.
1	일괄 업데이트를 사용하지 않습니다.
> 1	UpdateBatchSize개의 작업을 일괄적으로 사용하여 변경 내용이 한 번에 전송됩니다.

이 값을 1이 아닌 값으로 설정하면 DbDataAdapter와 연결된 모든 명령의 UpdatedRowSource 속성이 None이나 OutputParameters로 설정되어야 합니다. 그렇지 않으면 예외가 throw됩니다.

설명

UpdateBatchSize 속성을 사용하여 DataSet의 변경 내용으로 데이터 소스를 업데이트합니다. 데이터 공급자가 일괄 처리를 지원하는 경우 이렇게 하면 서버에 대한 라운드트립 수가 줄어들어 응용 프로그램 성능이 향상될 수 있습니다. ADO.NET 2.0에서 이 속성은 SQL Server(SqlClient)와 Oracle(OracleClient)의 .NET 데이터 공급자를 위해 지원됩니다.

큰 일괄 처리를 실행하면 성능이 저하될 수 있습니다. 따라서 응용 프로그램을 구현하기 전에 최적 일괄 처리 크기를 테스트해야 합니다.

값이 0보다 작은 수로 설정되면 ArgumentOutOfRangeException이 throw됩니다.

플랫폼

Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98, Windows CE, Windows Mobile for Smartphone, Windows Mobile for Pocket PC, Xbox 360

.NET Framework 및 .NET Compact Framework에서 모든 플랫폼의 전체 버전을 지원하지는 않습니다. 지원되는 버전의 목록을 보려면 .NET Framework 시스템 요구 사항을 참조하십시오.

버전 정보