updateCharacterStream 메서드(int, java.io.Reader, int)updateCharacterStream Method (int, java.io.Reader, int)

다운로드JDBC 드라이버 다운로드DownloadDownload JDBC Driver

지정된 열을 지정된 문자 수를 포함하는 문자 스트림 값으로 업데이트합니다.Updates the designated column with a character stream value, which will have the specified number of characters.

구문Syntax

  
public void updateCharacterStream(int columnIndex,  
                                  java.io.Reader readerValue,  
                                  int length)  

매개 변수Parameters

columnIndexcolumnIndex

열 인덱스를 나타내는 int 입니다.An int that indicates the column index.

readerValuereaderValue

Reader 개체입니다.A Reader object.

lengthlength

스트림의 길이를 나타내는 int 입니다.An int that indicates the length of the stream.

예외Exceptions

SQLServerExceptionSQLServerException

설명Remarks

이 updateCharacterStream 메서드는 java.sql.ResultSet 인터페이스의 updateCharacterStream 메서드에 의해 지정됩니다.This updateCharacterStream method is specified by the updateCharacterStream method in the java.sql.ResultSet interface.

이 메서드는 판독기 개체의 유니코드 문자를 선택된 텍스트 및 이진 열에 전달합니다.This method passes Unicode characters from a Reader object to selected text and binary columns. 여기에는 모든 텍스트 열과 binary, varbinary, varbinary(max) , imagexml 열이 포함되지만 udt 열은 포함되지 않습니다.This includes all text columns and binary, varbinary, varbinary(max), image, and xml columns, but not udt columns.

스트림의 길이가 length 매개 변수에 지정된 길이와 다르면 행이 업데이트되거나 삽입될 때 JDBC 드라이버에서 예외가 발생합니다.If the length of the stream is different than that specified in the length parameter, the JDBC driver throws an exception when the row is updated or inserted.

스트림의 길이를 알 수 없으면 length 매개 변수는 드라이버에서 스트림의 길이에 상관없이 스트림을 허용해야 함을 나타내는 -1로 설정될 수 있습니다.If the length of the stream is unknown, the length parameter may be set to -1 to indicate that the driver should accept the stream regardless of its length. sqljdbc4.jar을 사용하면 애플리케이션에서 길이를 알 수 없는 스트림에서 열을 업데이트하려고 할 때 JDBC 4.0 메서드 updateCharacterStream 메서드(int, java.io.Reader)를 사용하는 것이 좋습니다.With sqljdbc4.jar, we recommend that you use the JDBC 4.0 method updateCharacterStream Method (int, java.io.Reader) when the application wants to update the column from a stream whose length is unknown.

참고 항목See Also

updateCharacterStream 메서드(SQLServerResultSet) updateCharacterStream Method (SQLServerResultSet)
SQLServerResultSet 멤버 SQLServerResultSet Members
SQLServerResultSet 클래스SQLServerResultSet Class