Microsoft.VisualStudio.RemoteControl

An instance of this class represents reading from a particular file from disk.

Holds information about the settings file, downloaded from the server or from the local IE cache. Returned by calls to methods in this class.

Gets or sets a status code of the response from server

Gets or sets a stream to read the content of the settings file. ! May be null if is not OK. ! Callers must call Dispose on this object if it is not null.

Gets or sets a value indicating whether this information is obtained from IE cache.

Gets or sets the Age of the file in the cache if is true, returns . Otherwise null.

Gets or sets the error message if is not OK or NotFound.

Gets a value indicating whether is OK or NotFound.

An instance of this class represents reading from a particular file from disk.

Specifies the behavior of the IRemoteControlClient.ReadFile method

Return the settings file in the local cache irrespective of staleness.

Return the settings file in the local cache if it is not stale. Otherwise return Null.

Revalidate or download the file from the server and return it. WARNING: * each server request is billed and costs add up from millions of clients. * the only acceptable use of ForceDownload is very infrequently and if you absolutely cannot function without the latest settings * keep in mind that even once-per-process-lifetime may be too much if you process starts and stops very frequently.

Interface for the client for the Remote Control Service. This client polls the service for a single settings file and keeps it up-to-date in the local IE cache (which is per-user). Developers may call the or to read settings file.

Gets a full URL used to download to the file. Read-Only.

Gets a polling Interval to check the file on the server. Read-Only. This setting also determines when a file in the local IE cache is considered stale.

Reads the settings file based on the specified.

See for details about each possible setting. In most cases use the BehaviorOnStale.ReturnStale setting. !! WARNING about using BehaviorOnStale.ForceDownload !! * each server request is billed and costs add up from millions of clients. * the only acceptable use of ForceDownload is very infrequently and if you absolutely cannot function without the latest settings. * keep in mind that even once-per-process-lifetime may be too much if you process starts and stops very frequently. A Stream that can be used to read the setting file. !Callers must call Dispose on this stream object returned. Or Null is returned in case of failure to get the file (or if server returned NotFound).

Reads the settings file based on the specified. This is the Async version of ReadFile method.

See for details about each possible setting. In most cases use the BehaviorOnStale.ReturnStale setting. A Stream that can be used to read the setting file. !Callers must call Dispose on this stream object returned. Or Null is returned in case of failure to get the file (or if server returned NotFound).

Provides operation to issue HTTP requests to obtain a file, either from the server or from the local IE cache.

Reads the file from the server url. In case of errors reading the file from the server, returned object's IsSuccessStatusCode value will be false.

Information about the file obtained from the server

Reads the file from the local IE cache only. If the file does not exist in the cache, the returned object's IsCached value will be false and Code will be Unused.

Information about the file in the IE cache

Gets the elapsed time (in seconds) since the last error in downloading / revalidating the file from the server.

Time in seconds since last error or Int.MaxValue if no error has ever occured.

Cancels all in progress HTTP requests. Any future calls to this class should not be made.

Client for the Remote Control Service. This client polls the service for a single settings file and keeps it up-to-date in the local IE cache (which is per-user). Developers may call the or to read settings file.

Creates the client and starts polling.

HostId of the settings file (used to construct URL to the file: [baseUrl]/[hostId]/[relativePath]). Base URL of the service e.g. https://az700632.vo.msecnd.net Relative path used to contruct the full URL to the file: [baseUrl]/[hostId]/[relativePath] Optional. Default = 1440 minutes (24 hours). Min allowed = 5 minutes. Polling Interval (in minutes) to check the file on the server when the last request to the server succeeded. Optional. Default = 60 seconds. Maximum allowed = 60 seconds. HTTP request timeout used. Optional. Allows to set how often to send successful ReadFile telemetry, to prevent noise events Default = 1 (meaning post ReadFile telemetry every time). Min allowed is 1.

Only for testing. Testing "fake" IE Cache or "fake" server response

Only for testing. Testing local functionality

Gets or sets an action which allows setting of a Telemetry Logger to collect telemetry for usage of the Remote Control.

Gets or sets an action which allows setting of a Telemetry Logger to collect telemetry for usage of the Remote Control. Includes Pii-option.

Gets a full URL used to download to the file.

Gets a polling Interval to check the file on the server. This setting also determines when a file in the local IE cache is considered stale.

Reads the settings file based on the specified.

Reads the settings file based on the specified. This is the Async version of ReadFile method.

Disposes of client

Callback method for the update timer.

Dummy Cancellation token

Determines if a local IE cache copy of the file is up-to-date. If no cached copy is available or the cached copy is not up-to-date, a request is made to the server to download or revalidate the file. The result of the server request is cached.

Cancellation token to cancel waiting of operation Returns True if the copy in the IE cache is up-to-date by the end of the method. False in case of failures that prevent updating file.

Get a file and send telemetry events.

Instruments the usage of GetFileFromCache and GetFileFromServer.

Provides operation to issue HTTP requests to obtain a file, either from the server or from the local IE cache.

Ctor

Server URL to obtain the settings file Timeout in milliseconds for the HTTP requests issued by this class

Reads the file from the server url. In case of errors reading the file from the server, returned object's IsSuccessStatusCode value will be false.

Information about the file obtained from the server

Reads the file from the local IE cache only. If the file does not exist in the cache, the returned object's IsFromCache value will be false and Code will be Unused.

Information about the file in the IE cache

Gets the elapsed time (in seconds) since the last error in downloading / revalidating the file from the server.

Time in seconds since last error or Int.MaxValue if no error has ever occured.

Cancels all in progress HTTP requests. Any future calls to this class should not be made.

Extracts the value of Age header from .

HTTP response If Age header is present on can is valid, returns its value. Otherwise null.

In .Net 4.0 and above, in some cases, ConfigurationErrorsException will not be catch without the HandleProcessCorruptedStateExceptions and SecurityCritical attributes. The method should not be async. See Bug 172014 and https://msdn.microsoft.com/en-us/magazine/dd419661.aspx

This is the HTTP-facing method in the class. It essentially performs all functions of 1. sending an HTTP request for the file 2. if the response is from the server, ensuring that it is added to the IE cache 3. additonal logic to cache error responses in the IE cache. By default error responses are not cached.

Specifies chache policy to use when sending the request Result of the file lookup. See for details.

Copies all data in to a new Memory Stream to allow seeking.

Original Stream A new in memory stream

URI with optional redirect.

Gets a value indicating whether the URI points to a local file.

Gets a full URI string.

Gets a Host Id which was used to initialize the URI.

Creates a new URI with optional redirect.

Split the last path segment from the given URI.

Add a path segment to the given URI. The path segment may contain trailling '/'.

Provides a helper method to write empty files to the local IE cache. This is useful for writing HTTP error responses to the cache. Although caching of error responses is entirely allowed by HTTP protocol, The System.Net library does not add error responses to the cache. So, this helper library is used to call wininet.dll functions to do so.

Adds an empty file to the local IE cache with the header for the specified.

URL for which to add the cache entry Status of the response to cache True if operation succeeded. Otherwise false. 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