<loc>(JavaScript)
지역화 된 IntelliSense 정보를 제공 하는 사이드카 파일의 종류와 위치를 지정 합니다.
<loc filename="filename" format="vsdoc|messagebundle" />
매개 변수
filename
선택 사항입니다.중립 문화권에 대해 지역화 정보가 사이드카 파일의 루트 이름입니다.Visual Studio 대 한 지역화 정보를 검색 하는 경우 culture 별이이 파일의 버전을 찾으려면 시도 합니다.예를 들어, 경우 filename jquery.xml, Visual Studio (JA)와 같은 올바른 문화권별 폴더에 포함 된.js 파일은 같은 위치에 검색할 수 있는 <loc> 요소.문화권별 폴더를 찾은 경우 jquery.xml 파일에 있는지 여부를 확인 합니다.올바른 파일을 찾을 수 없는 경우 관리 되는 리소스 위치 규칙 대신 사용 됩니다.기본값은 filename 하지만.xml 확장명.js 대신 현재 파일의 이름입니다.format
선택 사항입니다.지역화에 사용 되는 사이드카 파일 유형을 지정 합니다.사용 messagebundle 열린 Ajax 메타 데이터에 의해 정의 된 메시지 번들의 사용을 지정 합니다.messagebundle권장 되는 형식이입니다.그러나이 형식에서 Microsoft Ajax 또는.winmd 파일에서 지원 되지 않습니다.사용 vsdoc Microsoft Ajax 및 Windows 런타임에서 사용 되는 표준.NET Framework 지역화 형식 지정 합니다.이 특성은 선택적 요소입니다.vsdoc기본 형식이입니다.
설명
<loc> 요소 같은 섹션으로 파일의 위쪽에 표시 되어야의 <reference> 요소.사용에 대 한 규칙은 <loc> 요소는 동일의 <reference> 요소.자세한 내용은 "참조 지시문" 섹션에서 JavaScript IntelliSense.
Visual Studio 단일 프로세스 <loc> 각.js 파일에 대 한 요소입니다.여러 경우 <loc> 요소가 없거나 하나만 <loc> 요소를 사용 합니다.동작을 결정 하는 것에 대 한 <loc> 요소를 사용 하 여 정의 됩니다.
번들 형식 메시지를 사용 하는 경우 사용 하는 locid 특성에서 지정 하는 XML 문서 주석에 name 특성 값.
예제
다음 예제에서는 <loc> messagebundle 형식의 요소.MessageFilename.xml 라는 파일에 다음 XML을 추가 하 고 파일의 설명에 지정 된 대로 정확한 문화권별 폴더에 배치 된 filename 매개 변수.
<?xml version="1.0" encoding="utf-8" ?>
<messagebundle>
<msg name="1">A class that represents a rectangle</msg>
<msg name="2">The height of a rectangle</msg>
<msg name="3">The width of a rectangle</msg>
</messagebundle>
Messagebundle 예제에 대 한 프로젝트에서 JavaScript 파일을 다음 코드를 추가 합니다.<loc> 요소의 JavaScript 파일에서 첫 번째 줄으로 표시 되어야 합니다.사용할 수 있는 경우이 코드는 설명은 지역화 된 설명으로 대체 됩니다.
/// <loc filename="messageFilename.xml" format="messagebundle"/>
function doSomething(a,b)
{
/// <summary locid='1'>description</summary>
/// <param name='a' locid='2'>parameter a description</param>
/// <param name='b' locid='3'>parameter b description</param>
}
다음 예제에서는 VSDoc 형식을 사용합니다.ScriptFilename.xml 라는 파일에 다음 XML을 추가 하 고 정확한 문화권별 폴더에 파일을 배치 합니다.
<?xml version="1.0" encoding="utf-8" ?>
<doc>
<assembly>
<name>Lights</name>
</assembly>
<members>
<member name="M:illuminate">
<summary>Activates a light. </summary>
<param name='a'>The light to activate. </param>
</member>
</members>
</doc>
VSDoc 예제에 대 한 프로젝트에서 JavaScript 파일을 다음 코드를 추가 합니다.사용할 수 있는 경우이 코드는 설명은 지역화 된 설명으로 대체 됩니다.
/// <loc filename="scriptFilename.xml" format="vsdoc" />
function illuminate(a)
{
/// <summary locid='M:illuminate'>description</summary>
/// <param name='a' type='Number'>parameter a description</param>
}