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
형식: System.String
선택적 요소.UI 리소스 문자열(아래 설명 부분 참조) 또는 새 파일 대화 상자에 "category\templatename" 형식으로 표시되는 내용에 기초한 항목에 대한 가상 경로입니다. Category는 대화 상자의 왼쪽 창, templatename은 오른쪽 창에서 가져옵니다.예를 들어 Visual Basic 프로젝트에 새 HTML 파일을 추가하려면 "일반\HTML 페이지" 형식을 사용하면 됩니다. 자세한 내용은 설명 부분을 참조하십시오.
- Name
형식: System.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 보안
- 직접 실행 호출자의 경우 완전히 신뢰합니다. 이 멤버는 부분적으로 신뢰할 수 있는 코드에서 사용할 수 없습니다. 자세한 내용은 부분 신뢰 코드에서 라이브러리 사용을 참조하십시오.