문자열 유틸리티 예제

StringUtilities 예제에는 쉼표로 구분된 문자열을 열이 하나인 테이블로 분할하는, Visual C# 및 Visual Basic으로 작성된 스트리밍 테이블 값 함수가 포함되어 있습니다. 또한 문자열 열을 쉼표로 구분된 문자열로 변환하는 집계 함수도 포함되어 있습니다.

concat.cs 및 concat.vb 원본 파일에는 집계 함수의 구현이 포함되어 있습니다. split.cs 및 split.vb 원본 파일에는 스트리밍 테이블 값 함수가 구현되어 있습니다. RegularExpression.cs 및 RegularExpression.vb 원본 파일은 정규식 대체 및 정규식 검색 기능을 제공하는 스칼라 함수와 테이블 값 함수를 구현합니다.

스트리밍 테이블 값 함수를 구현하려면 IEnumerable 인터페이스를 구현하는 개체를 반환하는 메서드를 만듭니다. IEnumerable 메서드는 테이블 값 함수의 행을 채우는 다른 메서드와 특성으로 연결되어야 합니다.

기본 설치 디렉터리는 drive:\Program Files\Microsoft SQL Server\90\Samples\Engine\Programmability\CLR\StringUtilities입니다.

시나리오

개발자가 호출자에게 값을 스트리밍하여 값 테이블을 반환하는 함수를 만들려고 합니다.

언어

Transact-SQL, Visual C# 및 Visual Basic

기능

StringUtilities 예제는 다음과 같은 SQL Server 2005 기능을 사용합니다.

응용 프로그램 영역	기능
전체	CLR(공용 언어 런타임)

필수 구성 요소

이 예제를 실행하기 전에 다음 소프트웨어가 설치되어 있는지 확인하십시오.

• SQL Server 2005 또는 SQL Server 2005 Express Edition(SQL Server Express). SQL Server 2005 Express Edition 설명서 및 예제 웹 사이트에서 무료로 SQL Server Express를 구할 수 있습니다.
• AdventureWorks 데이터베이스. SQL Server 2005에 포함되어 있으며 SQL Server Developer 웹 사이트에서도 구할 수 있습니다.
• SQL Server 2005 데이터베이스 엔진 예제. 이 예제는 SQL Server 2005에 포함되어 있습니다. SQL Server Developer 웹 사이트에서 최신 버전의 예제를 다운로드할 수 있습니다.
• .NET Framework SDK 2.0 또는 Microsoft Visual Studio 2005. .NET Framework SDK는 무료로 구할 수 있습니다. .NET Framework SDK 설치를 참조하십시오.

예제 빌드

예제를 빌드하려면 다음을 수행하십시오.

강력한 이름 키 파일을 생성하지 않았다면 다음 지침에 따라 해당 키 파일을 생성합니다.

강력한 이름 키 파일을 생성하려면

1. Microsoft Visual Studio 2005 명령 프롬프트를 엽니다. 시작을 클릭하고 모든 프로그램, Microsoft .NET Framework SDK 2.0을 차례로 가리킨 다음 SDK 명령 프롬프트를 클릭합니다.

   -- 또는--

   Microsoft .NET Framework 명령 프롬프트를 엽니다. 시작을 클릭하고 모든 프로그램, Microsoft .NET Framework SDK 2.0을 차례로 가리킨 다음 SDK 명령 프롬프트를 클릭합니다.

2. 디렉터리 변경 명령(CD)을 사용하여 명령 프롬프트 창의 현재 디렉터리를 예제가 설치된 폴더로 변경합니다.

   [!참고] 예제가 있는 폴더를 확인하려면 시작 단추를 클릭하고 모든 프로그램, Microsoft SQL Server, 설명서 및 자습서를 차례로 가리킨 다음 예제 디렉터리를 클릭하십시오. 기본 설치 위치가 사용된 경우 예제는 <system_drive>:\Program Files\Microsoft SQL Server\100\Samples에 있습니다.

3. 명령 프롬프트에서 다음 명령을 실행하여 키 파일을 생성합니다.

   sn -k SampleKey.snk

   중요:
   강력한 이름 키 쌍에 대한 자세한 내용은 MSDN의 .NET Development Center에서 "Security Briefs: Strong Names and Security in the .NET Framework"를 참조하십시오.

예제 빌드

1. Visual Studio 2005와 제공된 Visual Studio 솔루션을 사용하거나 .NET Framework SDK 2.0에 포함되어 있는 Microsoft MSBuild를 사용하여 예제를 컴파일합니다. 명령 프롬프트에서 다음과 비슷한 명령을 실행합니다.

   msbuild /nologo /verbosity:quiet /property:Configuration=Debug CS\StringUtilities.sln

2. AdventureWorks 데이터베이스가 설치되어 있는지 확인하고 필요하면 예제를 설치할 데이터베이스를 만듭니다.

3. SQL Server Management Studio에서 Visual C# 프로젝트를 컴파일했는지 또는 Visual Basic 프로젝트를 컴파일했는지에 따라 scripts\installCS.sql 또는 scripts\installVB.sql 파일을 엽니다. 파일에 포함된 스크립트를 실행하거나 명령 프롬프트에서 다음과 비슷한 명령을 실행합니다.

   sqlcmd -E -I -i Scripts\InstallCS.sql

   이 파일에는 SQL Server의 예제 CLR 개체를 설치 및 등록하는 데 필요한 스크립트가 포함되어 있습니다.

예제 실행

예제를 실행하려면 다음을 수행하십시오.

예제 실행

1. Management Studio에서 scripts\test.sql 파일을 열고 파일에 포함된 스크립트를 실행하거나 명령 프롬프트에서 다음 명령을 실행합니다.

   sqlcmd -E -I -i Scripts\test.sql

   이 스크립트는 예제의 일반적인 사용 방법을 보여 줍니다.

예제 제거

예제를 제거하려면 다음을 수행하십시오.

예제 제거

1. Management Studio에서 scripts\cleanup.sql 파일을 열고 파일에 포함된 스크립트를 실행하거나 명령 프롬프트에서 다음 명령을 실행합니다.

   sqlcmd -E -I -i Scripts\cleanup.sql

   이 스크립트는 예제를 제거합니다.

설명

이 예제가 제대로 작동되려면 SQL Server 2005 또는 SQL Server Express의 CLR을 설정해야 합니다.

예제는 교육용으로만 제공되므로 프로덕션 환경에서 사용하기에 적합하지 않으며 프로덕션 환경에서 테스트되지 않았습니다. Microsoft에서는 이러한 예제에 대해 기술 지원을 제공하지 않습니다. 시스템 관리자의 허가 없이 프로덕션 SQL Server 데이터베이스 또는 보고서 서버에 예제 응용 프로그램 및 어셈블리를 연결하거나 사용해서는 안 됩니다.

참고 항목

개념

CLR 프로그래밍 기능 예제

도움말 및 정보

SQL Server 2005 지원 받기

변경 내역

릴리스	내역
2005년 12월 5일	변경된 내용 키 파일의 이름 및 위치를 포함하여 키 파일 생성 방법에 대한 정보를 변경했습니다.
2006년 7월 17일	변경된 내용 빌드 지침을 수정하여 누락된 구문을 포함했습니다.