Uri Classe

Definizione

public ref class Uri sealed : IStringable

/// [Windows.Foundation.Metadata.Activatable(Windows.Foundation.IUriRuntimeClassFactory, 65536, Windows.Foundation.UniversalApiContract)]
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class Uri final : IStringable

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Activatable(Windows.Foundation.IUriRuntimeClassFactory, 65536, "Windows.Foundation.UniversalApiContract")]
class Uri final : IStringable

[Windows.Foundation.Metadata.Activatable(typeof(Windows.Foundation.IUriRuntimeClassFactory), 65536, typeof(Windows.Foundation.UniversalApiContract))]
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class Uri : IStringable

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Activatable(typeof(Windows.Foundation.IUriRuntimeClassFactory), 65536, "Windows.Foundation.UniversalApiContract")]
public sealed class Uri : IStringable

function Uri(baseUri, relativeUri)

Public NotInheritable Class Uri
Implements IStringable

Ereditarietà

Object Platform::Object IInspectable Uri

Attributi

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implementazioni

IStringable

Requisiti Windows

Esempio

In questo esempio viene creato un oggetto Uri che rappresenta un URI (Uniform Resource Identifier) che usa il protocollo http per accedere a un sito Web.

// The URI string
var uriToLaunch = "http://www.bing.com";

// Create a Uri object from the URI string
var uri = new Windows.Foundation.Uri(uriToLaunch);

// The URI string.
std::wstring uriToLaunch{ L"http://www.bing.com" };

// Create a Uri object from the URI string.
Windows::Foundation::Uri uri{ uriToLaunch };

// The URI string
var uriToLaunch = L"http://www.bing.com";

// Create a Uri object from the URI string
auto uri = ref new Windows::Foundation::Uri(uriToLaunch);

In questo esempio viene creato un URI che usa il protocollo ms-appx per accedere a un file di immagine nel pacchetto dell'app.

// The URI string
var uriImage = "ms-appx:///images/SecondaryTileDefault-sdk.png";

// Create a Uri object from the URI string
var uri = new Windows.Foundation.Uri(uriImage);

// The URI string.
std::wstring uriImage{ L"ms-appx:///images/SecondaryTileDefault-sdk.png" };

// Create a Uri object from the URI string.
Windows::Foundation::Uri uri{ uriImage };

// The URI string
var uriImage = ;

// Create a Uri object from the URI string
auto uri = ref new Windows::Foundation::Uri(uriImage);

In questo esempio viene creato un URI che usa il protocollo ms-appdata per accedere a un file nell'archivio dati dell'app locale per l'app.

// The URI string
var uriFile = "ms-appdata:///local/file.ext";

// Create a Uri object from the URI string
var uri = new Windows.Foundation.Uri(uriFile);

// The URI string.
std::wstring uriFile{ L"ms-appdata:///local/file.ext" };

// Create a Uri object from the URI string.
Windows::Foundation::Uri uri{ uriFile };

// The URI string
var uriFile = "ms-appdata:///local/file.ext";

// Create a Uri object from the URI string
auto uri = ref new Windows::Foundation::Uri(uriFile);

Commenti

I membri disponibili di System.Uri sono simili ma diversi dai membri di Windows.Foundation.Uri e alcuni dei comportamenti di base descritti in questo argomento sono diversi. Per altre informazioni sulle differenze di codifica e sui membri disponibili, vedere System.Uri (in particolare le osservazioni).

Ecco una suddivisione delle parti di un esempio di Uniform Resource Identifier (URI):

schema://username:password@host:port/path.estensione? Query#Frammento

Ad esempio:

http://msdn.microsoft.com/library/windows/apps/windows.foundation.uri.aspx?cs-save-lang=1&cs-lang=cpp#code-snippet-1

Esempio:

• schema è http
• host è msdn.microsoft.com
• dominio è microsoft.com (un subset di host)
• estensione è aspx
• query è cs-save-lang=1&cs-lang=cpp
• frammento è code-snippet-1

Schemi URI specifici di un'app Windows Runtime

Windows Runtime include diversi schemi univoci per un'app Windows Runtime e questi fanno riferimento agli asset che fanno parte dell'app. In genere, questi schemi sono quelli che è possibile usare anziché il file: schema, per fare riferimento a file in pacchetto e ad altri asset inclusi come parte del pacchetto dell'app o asset che altrimenti sono associati a un'app installata:

• ms-appx: fa riferimento ai file in pacchetto dell'app in locale.
• ms-appx-web: fa riferimento anche ai file in pacchetto locale dell'app, ma li carica in un contesto Web. Questo è spesso necessario se si accede agli asset per l'uso da WebView o la scrittura di app HTML/JavaScript e la richiesta da una pagina HTML. Per altre informazioni, vedere Schemi URI o Come fare riferimento al contenuto (HTML).
• ms-appdata: fa riferimento ai file di app provenienti dalle cartelle dati locali, mobili e temporanee dell'app. Per altre informazioni, vedere Schemi URI o Store e recuperare le impostazioni e altri dati dell'app.
• ms-resource: fa riferimento alle risorse dell'app nel sistema di gestione risorse. Per altre informazioni, vedere Localizzare le stringhe nell'interfaccia utente e nel manifesto del pacchetto dell'app.

Ognuno di questi schemi ignora molte delle parti del componente di un URI (Uniform Resource Identifier) destinate ad altri schemi, ad esempio Query e Fragment. Inoltre, alcuni componenti non sono consentiti in modo esplicito e causano che il valore Uri usando questi schemi venga considerato come input non valido,ad esempio i valori UserName e Password in un schema ms-appx: lo schema URI invaliderà un URI. Per altre info, vedi schemi URI.

Nella maggior parte dei casi, si usano questi schemi con tre barre (ad esempio: ms-appx:///page.html), che fa riferimento alla radice dell'app corrente, usando l'app corrente come autorità. Gli usi con due barre sono possibili, ma potrebbero richiedere di specificare in modo esplicito il nome dell'autorità. Gli usi con due barre possono fare riferimento a una dipendenza del pacchetto come autorità o possono fare riferimento a posizioni relative all'interno dell'app. Per altre info, vedi schemi URI.

URI assoluti e relativi

A livello di codice, l'Windows Runtime non supporta l'URI (Uniform Resource Identifier) relativo. Tutti gli oggetti URI creati devono rappresentare un URI (Uniform Resource Identifier) assoluto. Gli schemi elencati nella sezione precedente sono effettivamente URI (Uniform Resource Identifier), perché l'host e l'autorità sono impliciti per ogni schema e il resto del percorso viene valutato in base a tale autorità.

Avvio di un'app per schema URI

Lo schema URI (Uniform Resource Identifier) di un valore URI può essere usato per avviare altre app associate a tale schema specifico. Per altre informazioni, vedere Avviare l'app predefinita per un URI.

Costruttori

Proprietà

Metodi

Si applica a

Vedi anche

• WwwFormUrlDecoder
• System.Uri
• Come fare riferimento al contenuto (HTML)
• Come caricare le risorse file (XAML)
• Connessione a reti e servizi Web
• createObjectURL (per HTML/JavaScript)
• RFC 3986
• RFC 3987
• Esempio rssReader