API per gestire percorsi di file e risorse¶
Introduzione
Di seguito è descritta la classe C# statica ResourceUri
, che rappresenta il percorso (URI - Uniform Resource Identifier) di un file o una risorsa interno o esterno al progetto. La stessa classe rappresenta l’omonimo tipo di dato per le variabili (per esempio la proprietà Percorso di un oggetto Immagine).
Di seguito sono descritte le proprietà in lettura della classe ResourceUri
e i metodi che la classe espone per referenziare file/risorse.
Proprietà di un oggetto ResourceUri
Proprietà |
Tipo di dato |
Descrizione |
---|---|---|
UriType |
UriType |
Tipo di percorso contenuto:
|
ProjectRelativePath |
string |
Percorso relativo di un file rispetto alla cartella ProjectFiles |
ApplicationRelativePath |
string |
Percorso relativo di un file rispetto alla cartella ApplicationFiles |
AbsoluteFilePath |
string |
Percorso assoluto di un file esterno al progetto |
Uri |
string |
Percorso assoluto di una risorsa generica |
A seconda del valore della proprietà UriType
di un oggetto di tipo ResourceUri
, le altre proprietà espongono o meno un valore, come di seguito:
UriType |
ProjectRelativePath |
ApplicationRelativePath |
AbsoluteFilePath |
Uri |
---|---|---|---|---|
Uri |
- |
- |
- |
URI (per esempio un URL HTTP) |
ProjectRelative |
Percorso relativo rispetto alla cartella ProjectFiles |
- |
- |
Percorso assoluto |
ApplicationRelative |
- |
Percorso relativo rispetto alla cartella ApplicationFiles |
- |
Percorso assoluto |
AbsoluteFilePath |
- |
- |
Percorso assoluto |
Percorso assoluto |
ResourceUri.FromAbsolutePath(path)¶
Restituisce un oggetto C# di tipo ResourceUri
, con UriType
= AbsoluteFilePath e contenente un percorso assoluto di un file.
static ResourceUri FromAbsoluteFilePath(string path);
Argomenti
path
string
Percorso assoluto di un file.
Restituisce
ResourceUri
Oggetto C# che contiene il percorso indicato nell’argomento.
Esempio
Di seguito un esempio in cui l’API restituisce un oggetto C# applicationRelativeResourceUri
di tipo ResourceUri
contenente il percorso relativo C:\Users\Michael\Desktop\Text1.txt.
var applicationRelativeResourceUri = ResourceUri.FromAbsolutePath("C:\Users\Michael\Desktop\Text1.txt");
ResourceUri.FromApplicationRelativePath(path)¶
Restituisce un oggetto C# di tipo ResourceUri
, con UriType
= ApplicationRelative e contenente un percorso relativo di un file rispetto alla cartella ApplicationFiles.
static ResourceUri FromApplicationRelativePath(string path);
Argomenti
path
string
Percorso relativo di un file rispetto alla cartella ApplicationFiles.
Restituisce
ResourceUri
Oggetto C# che contiene il percorso indicato nell’argomento.
Esempio
Di seguito un esempio in cui l’API restituisce un oggetto C# applicationRelativeResourceUri
di tipo ResourceUri
contenente il percorso relativo Text1.txt. L’oggetto viene usato come argomento dell’API .NET WriteAllText
per creare un file di testo Text1.txt all’interno della cartella ApplicationFiles.
var applicationRelativeResourceUri = ResourceUri.FromApplicationRelativePath("Text1.txt");
Log.Info(applicationRelativeResourceUri.ApplicationRelativePath);
File.WriteAllText(applicationRelativeResourceUri.Uri, "Hello world!");
ResourceUri.FromProjectRelativePath(path)¶
Restituisce un oggetto C# di tipo ResourceUri
, con UriType
= ProjectRelative e contenente un percorso relativo di un file rispetto alla cartella ProjectFiles.
static ResourceUri FromProjectRelativePath(string path);
Argomenti
path
string
Percorso relativo di un file rispetto alla cartella ProjectFiles.
Restituisce
ResourceUri
Oggetto C# che contiene il percorso indicato nell’argomento.
Esempio
Di seguito un esempio in cui l’API restituisce un oggetto C# projectRelativeResourceUri
di tipo ResourceUri
contenente il percorso relativo Text1.txt. L’oggetto viene usato come argomento dell’API .NET WriteAllText
per creare un file di testo Text1.txt all’interno della cartella ProjectFiles.
var projectRelativeResourceUri = ResourceUri.FromProjectRelativePath("Text1.txt");
Log.Info(projectRelativeResourceUri.ProjectRelativePath);
File.WriteAllText(projectRelativeResourceUri.Uri, "Hello world!");
ResourceUri.FromUri(uri)¶
Restituisce un oggetto C# di tipo ResourceUri
, con UriType
= Uri e contenente un percorso assoluto di una risorsa generica, solitamente un percorso di rete o l’indirizzo di un sito web.
Argomenti
uri
string
Percorso assoluto di una risorsa generica.
Restituisce
ResourceUri
Oggetto C# che contiene il percorso indicato nell’argomento.
Esempio
Di seguito un esempio in cui l’API restituisce un oggetto C# website
di tipo ResourceUri
contenente l’URL www.asem.it.
var website = ResourceUri.FromUri("www.asem.it");