GdPicture.NET.14.API
GdPicture14 Namespace / GdPictureImaging Class / CreateGdPictureImageFromHTTP Method / CreateGdPictureImageFromHTTP(String,String,String) Method
The full URI path with the full image file name, where the file is located, for example http://www.gdpicture.com/demo/image.jpg .
The login required to authenticate on the server. It can be an empty string.
The password required to authenticate on the server. It can be an empty string.





In This Topic
CreateGdPictureImageFromHTTP(String,String,String) Method
In This Topic
Creates a new GdPicture image from an image file stored on a distant server using HTTP protocol according to what you have specified. The newly created image is identified by its unique non-zero image identifier.

Please note that it is your responsibility to release the image resources once you have no use for them.

Syntax
'Declaration
 
Public Overloads Function CreateGdPictureImageFromHTTP( _
   ByVal Uri As String, _
   ByVal Login As String, _
   ByVal Password As String _
) As Integer
public int CreateGdPictureImageFromHTTP( 
   string Uri,
   string Login,
   string Password
)
public function CreateGdPictureImageFromHTTP( 
    Uri: String;
    Login: String;
    Password: String
): Integer; 
public function CreateGdPictureImageFromHTTP( 
   Uri : String,
   Login : String,
   Password : String
) : int;
public: int CreateGdPictureImageFromHTTP( 
   string* Uri,
   string* Login,
   string* Password
) 
public:
int CreateGdPictureImageFromHTTP( 
   String^ Uri,
   String^ Login,
   String^ Password
) 

Parameters

Uri
The full URI path with the full image file name, where the file is located, for example http://www.gdpicture.com/demo/image.jpg .
Login
The login required to authenticate on the server. It can be an empty string.
Password
The password required to authenticate on the server. It can be an empty string.

Return Value

A unique image identifier of the GdPicture image representing the newly created image. The returned value is non-zero if the image is successfully created. Please first of all use the GdPictureImaging.GetStat method to determine if this method has been successful.

Use the GdPictureImaging.GetLastTransferError method to diagnose the error if this method has failed with one of the GdPictureStatus.Internet... errors.

Be aware that you need to release the image with the GdPictureImaging.ReleaseGdPictureImage method after being used.

Remarks
It is recommend to use the GdPictureImaging.GetStat method to identify the specific reason for the method's failure, if any.

All document formats currently supported by the toolkit are listed here.

This class loads multipage images (GIF and TIFF formats) in read-write mode by default. If you want to open multipage images in read-only mode, you need to call the GdPictureImaging.GifOpenMultiFrameForWrite method for GIF format and the GdPictureImaging.TiffOpenMultiPageForWrite method for TIFF format and set the WriteAccess parameter to false before creating an image.

This method requires the Image Documents component to run.

See Also