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와 위치를 보여 줍니다.

예제

Sub AddNewItemExample()
   Dim ItemOp As ItemOperations
   ItemOp = DTE.ItemOperations
   ItemOp.AddNewItem("General\Text File", "A new text file")
End Sub

.NET Framework 보안

• 직접 실행 호출자의 경우 완전히 신뢰합니다. 이 멤버는 부분적으로 신뢰할 수 있는 코드에서 사용할 수 없습니다. 자세한 내용은 부분 신뢰 코드에서 라이브러리 사용를 참조하세요.

참고 항목

참조

ItemOperations 인터페이스

EnvDTE 네임스페이스