ItemOperations.AddNewItem 메서드
새 항목을 현재 프로젝트에 추가합니다.
네임스페이스: EnvDTE
어셈블리: EnvDTE(EnvDTE.dll)
구문
‘선언
Function AddNewItem ( _
Item As String, _
Name As String _
) As ProjectItem
ProjectItem AddNewItem(
string Item,
string Name
)
ProjectItem^ AddNewItem(
[InAttribute] String^ Item,
[InAttribute] String^ Name
)
abstract AddNewItem :
Item:string *
Name:string -> ProjectItem
function AddNewItem(
Item : String,
Name : String
) : ProjectItem
매개 변수
Item
형식: String선택 사항 UI 리소스 문자열(아래 설명 부분 참조) 또는 새 파일 대화 상자에 "category\templatename" 형식으로 표시되는 내용에 기초한 항목에 대한 가상 경로입니다. Category는 대화 상자의 왼쪽 창, templatename은 오른쪽 창에서 가져옵니다. 예를 들어 Visual Basic 프로젝트에 새 HTML 파일을 추가하려면 "일반\HTML 페이지" 형식을 사용하면 됩니다. 자세한 내용은 설명 부분을 참조하십시오.
Name
형식: String선택 사항 프로젝트에 항목이 추가되는 경우 해당 항목에 사용할 표시 이름입니다.
반환 값
형식: EnvDTE.ProjectItem
ProjectItem 개체
설명
AddNewItem은 새 파일 대화 상자를 모델링합니다. 이 대화 상자의 내용은 프로젝트 형식에 따라 다릅니다. 두 가지 방법으로 Item 매개 변수에 사용할 값을 결정할 수 있습니다. 즉, 새 파일 대화 상자에서 값을 조회할 수도 있고 해당 UI 리소스 파일에서 값을 조회할 수도 있습니다.
첫 번째 방법으로 프로젝트에 항목을 추가하려면 새 파일 대화 상자에서 프로젝트에 사용할 수 있는 항목을 찾습니다. 새 파일 대화 상자에는 범주와 템플릿이라는 두 개의 창이 있습니다. AddNewItem 메서드의 Item 매개 변수는
"category\templatename" 형식으로 일반적으로 Category는 대화 상자의 왼쪽 창(범주)에서, templatename은 오른쪽 창(템플릿)에서 가져옵니다. 예를 들어 Visual Basic 프로젝트에 새 HTML 파일을 추가하려면 "일반\HTML 페이지" 형식을 사용하면 됩니다. 그러나 언어상의 차이로 인해 새 파일 대화 상자에 정확한 값이 반영되지 않을 수도 있습니다.
Item 매개 변수에 사용할 정확한 값을 보다 일관성 있게 가져올 수 있는 신뢰할 수 있는 방법은 각 프로그래밍 언어의 UI 리소스 파일에서 필요한 문자열을 조회하는 것입니다. 그런 다음 새 파일 및 새 항목 추가 대화 상자에 표시되는 추가할 항목의 이름과 함께 이 값을 사용할 수 있습니다. 예를 들어 프로젝트에 새 Visual Basic 클래스 파일을 추가하려면 AddNewItem("Visual Basic Items\Class", "test.vb")을 사용합니다. 프로젝트에 새 Visual C# 클래스를 추가하려면 AddNewItem("Visual C# Project Items\Class", test.cs");을 사용합니다.
"Visual Basic Items" 및 기타 언어 항목의 문자열은 다음과 같은 방법으로 찾을 수 있습니다.
Visual Basic 파일의 경우 HKEY_LOCAL_MACHINE\Software\Microsoft\VisualStudio\8.0\Projects\{F184B08F-C81C-45f6-A57F-5ABD9991F28F}\AdditemTemplates\TemplateDirs\{164B10B9-B200-11D0-8C61-00A0C91E29D5}\ /1 레지스트리 키를 엽니다. 기본값은 #3082입니다.
Visual Studio에서 리소스 편집기를 사용하여 msvbprjui.dll 파일을 엽니다. 이 파일을 열려면 파일 메뉴에 있는 열기 메뉴에서 파일…을 선택한 다음 파일을 엽니다. 문자열 테이블 노드를 열고 리소스 ID 3082를 살펴보면 "Visual Basic Items"로 설정되어 있습니다. 이 문자열을 AddNewItem 호출에 사용합니다. Visual C#, Visual C++ 및 Visual C# 프로젝트 시스템에도 같은 절차가 적용되지만 사용할 파일 이름과 리소스 ID가 달라집니다.
다음 표에서는 UI 리소스 파일의 리소스 ID와 위치를 보여 줍니다.
프로그래밍 언어 |
UI 파일 이름 |
클래스의 리소스 ID |
|---|---|---|
Visual Basic |
…\Program Files\Microsoft Visual Studio 8\VB\Bin\1033\msvbprojUI.dll |
3082 |
Visual C# |
…\Program Files\Microsoft Visual Studio 8\VC#\VCSPackages\1033\csprjui.dll |
2346 |
Visual C++ |
…\Program Files\Microsoft Visual Studio 8\VC\vcpackages\1033\VCProjectUI.dll |
10007 |
예제
Sub AddNewItemExample()
Dim ItemOp As ItemOperations
ItemOp = DTE.ItemOperations
ItemOp.AddNewItem("General\Text File", "A new text file")
End Sub
.NET Framework 보안
- 직접 실행 호출자의 경우 완전히 신뢰합니다. 이 멤버는 부분적으로 신뢰할 수 있는 코드에서 사용할 수 없습니다. 자세한 내용은 부분 신뢰 코드에서 라이브러리 사용를 참조하세요.