Updategram에 매개 변수 전달(SQLXML 4.0)

  • 아티클

Updategram은 템플릿이므로 Updategram에 매개 변수를 전달할 수 있습니다. 매개 변수를 템플릿에 전달하는 방법은 Updategram 보안 고려 사항(SQLXML 4.0)을 참조하십시오.

Updategram을 사용하면 NULL을 매개 변수 값으로 전달할 수 있습니다. NULL 매개 변수 값을 전달하려면 nullvalue 특성을 지정합니다. 그런 다음 nullvalue 특성에 할당된 값을 매개 변수 값으로 제공합니다. Updategram은 이 값을 NULL로 처리합니다.

[!참고]

<sql:header> 및 <updg:header>에서는 nullvalue를 unqualified로 지정해야 하는 반면 <updg:sync>에서는 nullvalue를 qualified로 지정합니다(예: updg:nullvalue).

예

다음 예를 사용하여 작업 예제를 만들려면 SQLXML 예 실행을 위한 요구 사항에 지정된 요구 사항이 충족되어야 합니다.

Updategram 예를 사용하기 전에 다음 사항을 확인하십시오.

1.Updategram에 매개 변수 전달

이 예에서 Updategram은 HumanResources.Shift 테이블에 있는 직원의 성을 변경합니다. Updategram에 두 개의 매개 변수(근무조를 고유하게 식별하는 데 사용되는 ShiftID 및 Name)가 전달됩니다.

<ROOT xmlns:updg="urn:schemas-microsoft-com:xml-updategram">
<updg:header>
  <updg:param name="ShiftID"/>
  <updg:param name="Name" />
</updg:header>
  <updg:sync >
    <updg:before>
       <HumanResources.Shift ShiftID="$ShiftID" />
    </updg:before>
    <updg:after>
      <HumanResources.Shift Name="$Name" />
    </updg:after>
  </updg:sync>
</ROOT>

Updategram을 테스트하려면

  1. 위의 Updategram을 메모장에 복사하고 UpdategramWithParameters.xml로 파일에 저장합니다.

  2. cmd.Properties("Output Stream").Value = outStream 다음에 아래 줄을 추가하여 Updategram을 실행하기 위해 ADO를 사용하여 SQLXML 4.0 쿼리 실행의 SQLXML 4.0 테스트 스크립트(Sqlxml4test.vbs)를 준비합니다.

    cmd.NamedParameters = True
' CreateParameter arguments: Name, Type, Direction, Size, Value
cmd.Parameters.Append cmd.CreateParameter("@ShiftID",  2, 1,  0, 1)
cmd.Parameters.Append cmd.CreateParameter("@Name",   200, 1, 50, "New Name")

2.NULL을 매개 변수 값으로 Updategram에 전달

Updategram을 실행하면 NULL로 설정할 매개 변수에 "isnull" 값이 할당됩니다. Updategram은 "isnulll" 매개 변수 값을 NULL로 변환하고 적절하게 처리합니다.

다음 Updategram에서는 직원 직함을 NULL로 설정합니다.

<ROOT xmlns:updg="urn:schemas-microsoft-com:xml-updategram">
<updg:header nullvalue="isnull" >
  <updg:param name="EmployeeID"/>
  <updg:param name="ManagerID" />
</updg:header>
  <updg:sync >
    <updg:before>
       <HumanResources.Employee EmployeeID="$EmployeeID" />
    </updg:before>
    <updg:after>
      <HumanResources.Employee ManagerID="$ManagerID" />
    </updg:after>
  </updg:sync>
</ROOT>

Updategram을 테스트하려면

  1. 위의 Updategram을 메모장에 복사하고 UpdategramPassingNullvalues.xml로 파일에 저장합니다.

  2. cmd.Properties("Output Stream").Value = outStream 다음에 아래 줄을 추가하여 Updategram을 실행하기 위해 ADO를 사용하여 SQLXML 4.0 쿼리 실행의 SQLXML 4.0 테스트 스크립트(Sqlxml4test.vbs)를 준비합니다.

    cmd.NamedParameters = True
' CreateParameter arguments: Name, Type, Direction, Size, Value 
cmd.Parameters.Append cmd.CreateParameter("@EmployeeID", 3, 1, 0, 1)
cmd.Parameters.Append cmd.CreateParameter("@ManagerID",  3, 1, 0, Null)

참고 항목

참조

Updategram 보안 고려 사항(SQLXML 4.0)