Parameter 개체Parameter Object

매개 변수가 있는 쿼리 또는 저장 프로시저를 기반으로 Command 개체와 연결 된 매개 변수 또는 인수를 나타냅니다.Represents a parameter or argument associated with a Command object based on a parameterized query or stored procedure.

설명Remarks

많은 공급자가 매개 변수가 있는 명령을 지원 합니다.Many providers support parameterized commands. 이러한 명령은 원하는 작업을 한 번 정의 하지만 변수 (또는 매개 변수)를 사용 하 여 명령의 일부 세부 정보를 변경 하는 명령입니다.These are commands in which the desired action is defined once, but variables (or parameters) are used to alter some details of the command. 예를 들어 SQL SELECT 문은 매개 변수를 사용 하 여 WHERE 절의 일치 조건을 정의 하 고 다른 매개 변수를 사용 하 여 SORT BY 절의 열 이름을 정의할 수 있습니다.For example, an SQL SELECT statement could use a parameter to define the matching criteria of a WHERE clause, and another to define the column name for a SORT BY clause.

매개 변수 개체는 매개 변수가 있는 쿼리와 관련 된 매개 변수 또는 in/out 인수 및 저장 프로시저의 반환 값을 나타냅니다.Parameter objects represent parameters associated with parameterized queries, or the in/out arguments and the return values of stored procedures. 공급자의 기능에 따라 매개 변수 개체의 일부 컬렉션, 메서드 또는 속성을 사용 하지 못할 수도 있습니다.Depending on the functionality of the provider, some collections, methods, or properties of a Parameter object may not be available.

매개 변수 개체의 컬렉션, 메서드 및 속성을 사용 하 여 다음을 수행할 수 있습니다.With the collections, methods, and properties of a Parameter object, you can do the following:

  • Name 속성을 사용 하 여 매개 변수의 이름을 설정 하거나 반환 합니다.Set or return the name of a parameter with the Name property.

  • Value 속성을 사용 하 여 매개 변수의 값을 설정 하거나 반환 합니다.Set or return the value of a parameter with the Value property. Value매개 변수 개체의 기본 속성입니다.Value is the default property of the Parameter object.

  • 특성, 방향, 전체 자릿수, NumericScale, 크기유형 속성을 사용 하 여 매개 변수 특성을 설정 하거나 반환 합니다.Set or return parameter characteristics with the Attributes, Direction, Precision, NumericScale, Size, and Type properties.

  • AppendChunk 메서드를 사용 하 여 긴 이진 또는 문자 데이터를 매개 변수에 전달 합니다.Pass long binary or character data to a parameter with the AppendChunk method.

  • Properties 컬렉션을 사용 하 여 공급자별 특성에 액세스 합니다.Access provider-specific attributes by using the Properties collection.

호출 하려는 저장 프로시저 또는 매개 변수가 있는 쿼리와 연결 된 매개 변수의 이름 및 속성을 알고 있는 경우 Createparameter 메서드를 사용 하 여 적절 한 속성 설정을 사용 하 여 매개 변수 개체를 만들고 Append 메서드를 사용 하 여 매개 변수 컬렉션에 추가할 수 있습니다.If you know the names and properties of the parameters associated with the stored procedure or parameterized query you want to call, you can use the CreateParameter method to create Parameter objects with the appropriate property settings and use the Append method to add them to the Parameters collection. 이렇게 하면 리소스를 많이 사용 하는 작업 인 공급자에서 매개 변수 정보를 검색 하기 위해 Parameters 컬렉션에서 Refresh 메서드를 호출 하지 않고도 매개 변수 값을 설정 하 고 반환할 수 있습니다.This lets you set and return parameter values without having to call the Refresh method on the Parameters collection to retrieve the parameter information from the provider, a potentially resource-intensive operation.

매개 변수 개체는 스크립팅에 안전 하지 않습니다.The Parameter object is not safe for scripting.

이 섹션에는 다음 항목이 포함 되어 있습니다.This section contains the following topic.

참고 항목See Also

Command 개체 (ADO) Command Object (ADO)
CreateParameter 메서드 (ADO) CreateParameter Method (ADO)
Parameters 컬렉션 (ADO) Parameters Collection (ADO)
Properties 컬렉션(ADO)Properties Collection (ADO)