AppUriHandlerRegistration.SetAppAddedHostsAsync Method

Definition

Namespace:

Windows.System

Registers hosts in addition to the hosts already defined in the AppxManifest.

public:
 virtual IAsyncAction ^ SetAppAddedHostsAsync(IIterable<AppUriHandlerHost ^> ^ hosts) = SetAppAddedHostsAsync;

/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncAction SetAppAddedHostsAsync(IIterable<AppUriHandlerHost> const& hosts);

[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncAction SetAppAddedHostsAsync(IEnumerable<AppUriHandlerHost> hosts);

function setAppAddedHostsAsync(hosts)

Public Function SetAppAddedHostsAsync (hosts As IEnumerable(Of AppUriHandlerHost)) As IAsyncAction

Parameters

hosts

IIterable<AppUriHandlerHost>

IEnumerable<AppUriHandlerHost>

The set of AppUriHandlerHost objects to register.

Returns

IAsyncAction

Represents the asynchronous action.

Attributes

RemoteAsyncAttribute

Examples

// Application logic can determine which are the new domains to register 
// Here we just have a hardcoded list. 
List<AppUriHandlerHost> hosts = await registration.GetAppAddedHostsAsync(); 

// Application logic can determine which are the new domains to register 
hosts.AddRange(new[] { 
    new AppUriHandlerHost("www.contoso.com"), 
    new AppUriHandlerHost("*.example.contoso.com") 
    }); 

// Application logic can determine which domains to remove from the list 
hosts.RemoveAll(_ => _.Name == "removed.contoso.com"); 

await registration.SetAppAddedHostsAsync(hosts); 

Remarks

This API does not override, replace, or remove entries that are registered via the AppxManifest.