VSProject.GetUniqueFilename (Método)
Genera un nombre de archivo único en el proyecto. Se usa para asignar nombre a los nuevos elementos del proyecto.
Espacio de nombres: VSLangProj
Ensamblado: VSLangProj (en VSLangProj.dll)
Sintaxis
'Declaración
Function GetUniqueFilename ( _
pDispatch As Object, _
bstrRoot As String, _
bstrDesiredExt As String _
) As String
string GetUniqueFilename(
Object pDispatch,
string bstrRoot,
string bstrDesiredExt
)
String^ GetUniqueFilename(
[InAttribute] Object^ pDispatch,
[InAttribute] String^ bstrRoot,
[InAttribute] String^ bstrDesiredExt
)
abstract GetUniqueFilename :
pDispatch:Object *
bstrRoot:string *
bstrDesiredExt:string -> string
function GetUniqueFilename(
pDispatch : Object,
bstrRoot : String,
bstrDesiredExt : String
) : String
Parámetros
- pDispatch
Tipo: System.Object
El nombre generado tendrá este valor como extensión.
- bstrRoot
Tipo: System.String
Objeto Project u objeto ProjectItem de carpeta.El nombre de archivo generado será único en este contexto.
- bstrDesiredExt
Tipo: System.String
El nombre generado comenzará con esta cadena.
Valor devuelto
Tipo: System.String
Nombre de archivo que es único en el proyecto o en la carpeta del proyecto.Si el primer parámetro es una instancia del objeto Project, el nombre generado será único en la carpeta raíz del proyecto.El nombre de archivo adoptará el formato Raíz?.Extensión, donde ? corresponde a uno o varios numerales (1, 2, 3, etc.).
Comentarios
Un uso típico de este método consiste en generar un nombre para un nuevo elemento del proyecto.
Si se llama a este método con KeyFile como raíz y snk como extensión, la cadena devuelta es KeyFile.snk si el archivo KeyFile.snk no existe todavía. Si existe, se devuelve KeyFile1.snk. Debe tenerse en cuenta que si se realizan varias llamadas a este método y no se crea ningún archivo a partir del nombre de archivo devuelto, todas las llamadas devolverán el mismo valor. El resultado depende sólo de los archivos que existan en el momento de la llamada al método.
Ejemplos
[Visual Basic]
' This macro displays a file name that is unique in the
' project folder, in the form root?.ext.
' Macro editor
Imports VSLangProj
Imports VSLangProj80
Sub GetUniqueName()
Dim proj As Project
proj = DTE.Solution.Projects.Item(1)
Dim vsproj As VSLangProj.VSProject = _
CType(proj.Object, VSLangProj.VSProject)
MsgBox(vsproj.GetUniqueFilename(proj, "Root", "ext"))
End Sub
Seguridad de .NET Framework
- Plena confianza para el llamador inmediato. Un código de confianza parcial no puede utilizar este miembro. Para obtener más información, vea Utilizar bibliotecas de código que no es de plena confianza.