Kelas CUrl

Artikel
06/16/2023

Kelas ini mewakili URL. Ini memungkinkan Anda untuk memanipulasi setiap elemen URL secara independen dari yang lain apakah mengurai string URL yang ada atau membangun string dari awal.

Penting

Kelas ini dan anggotanya tidak dapat digunakan dalam aplikasi yang dijalankan di Windows Runtime.

Sintaks

class CUrl

Anggota

Konstruktor Publik

Nama	Deskripsi
CUrl::CUrl	Konstruktor.
CUrl::~CUrl	Destruktor.

Metode Publik

Nama	Deskripsi
CUrl::Canonicalize	Panggil metode ini untuk mengonversi string URL ke bentuk kanonis.
CUrl::Clear	Panggil metode ini untuk menghapus semua bidang URL.
CUrl::CrackUrl	Panggil metode ini untuk mendekode dan mengurai URL.
CUrl::CreateUrl	Panggil metode ini untuk membuat URL.
CUrl::GetExtraInfo	Panggil metode ini untuk mendapatkan informasi tambahan (seperti teks atau # teks) dari URL.
CUrl::GetExtraInfoLength	Panggil metode ini untuk mendapatkan panjang informasi tambahan (seperti teks atau # teks) untuk diambil dari URL.
CUrl::GetHostName	Panggil metode ini untuk mendapatkan nama host dari URL.
CUrl::GetHostNameLength	Panggil metode ini untuk mendapatkan panjang nama host.
CUrl::GetPassword	Panggil metode ini untuk mendapatkan kata sandi dari URL.
CUrl::GetPasswordLength	Panggil metode ini untuk mendapatkan panjang kata sandi.
CUrl::GetPortNumber	Panggil metode ini untuk mendapatkan nomor port dalam hal ATL_URL_PORT.
CUrl::GetScheme	Panggil metode ini untuk mendapatkan skema URL.
CUrl::GetSchemeName	Panggil metode ini untuk mendapatkan nama skema URL.
CUrl::GetSchemeNameLength	Panggil metode ini untuk mendapatkan panjang nama skema URL.
CUrl::GetUrlLength	Panggil metode ini untuk mendapatkan panjang URL.
CUrl::GetUrlPath	Panggil metode ini untuk mendapatkan jalur URL.
CUrl::GetUrlPathLength	Panggil metode ini untuk mendapatkan panjang jalur URL.
CUrl::GetUserName	Panggil metode ini untuk mendapatkan nama pengguna dari URL.
CUrl::GetUserNameLength	Panggil metode ini untuk mendapatkan panjang nama pengguna.
CUrl::SetExtraInfo	Panggil metode ini untuk mengatur informasi tambahan (seperti teks atau # teks) URL.
CUrl::SetHostName	Panggil metode ini untuk mengatur nama host.
CUrl::SetPassword	Panggil metode ini untuk mengatur kata sandi.
CUrl::SetPortNumber	Panggil metode ini untuk mengatur nomor port dalam hal ATL_URL_PORT.
CUrl::SetScheme	Panggil metode ini untuk mengatur skema URL.
CUrl::SetSchemeName	Panggil metode ini untuk mengatur nama skema URL.
CUrl::SetUrlPath	Panggil metode ini untuk mengatur jalur URL.
CUrl::SetUserName	Panggil metode ini untuk mengatur nama pengguna.

Operator Publik

Nama	Deskripsi
CUrl::operator =	Menetapkan objek yang ditentukan `CUrl` ke objek saat ini `CUrl` .

Keterangan

CUrl memungkinkan Anda memanipulasi bidang URL, seperti jalur atau nomor port. CUrl memahami URL formulir berikut:

(Beberapa bidang bersifat opsional.) Misalnya, pertimbangkan URL ini:

http://someone:secret@www.microsoft.com:80/visualc/stuff.htm#contents

CUrl::CrackUrl mengurainya sebagai berikut:

Skema: "http" atau ATL_URL_SCHEME_HTTP
UserName: "someone"
Kata sandi: "rahasia"
HostName: "www.microsoft.com"
PortNumber: 80
UrlPath: "visualc/stuff.htm"
ExtraInfo: "#contents"

Untuk memanipulasi bidang UrlPath (misalnya), Anda akan menggunakan GetUrlPath, GetUrlPathLength, dan SetUrlPath. Anda akan menggunakan CreateUrl untuk membuat string URL lengkap.

Persyaratan

Header: atlutil.h

CUrl::Canonicalize

Panggil metode ini untuk mengonversi string URL ke bentuk kanonis.

inline BOOL Canonicalize(DWORD dwFlags = 0) throw();

Parameter

dwFlags
Bendera yang mengontrol kanonisisasi. Jika tidak ada bendera yang ditentukan (dwFlags = 0), metode mengonversi semua karakter yang tidak aman dan urutan meta (seperti \.,\ .., dan \...) untuk meloloskan urutan. dwFlags dapat menjadi salah satu nilai berikut:

ATL_URL_BROWSER_MODE: Tidak mengodekan atau mendekode karakter setelah "#" atau "" dan tidak menghapus spasi kosong berikutnya setelah "". Jika nilai ini tidak ditentukan, seluruh URL dikodekan dan spasi kosong berikutnya dihapus.
ATL_URL _DECODE: Mengonversi semua urutan %XX menjadi karakter, termasuk urutan escape, sebelum URL diurai.
ATL_URL _ENCODE_PERCENT: Mengodekan tanda persen yang ditemui. Secara default, tanda persen tidak dikodekan.
ATL_URL _ENCODE_SPACES_ONLY: Mengodekan spasi saja.
ATL_URL _NO_ENCODE: Tidak mengonversi karakter yang tidak aman untuk meloloskan urutan.
ATL_URL _NO_META: Tidak menghapus urutan meta (seperti "." dan "..") dari URL.

Tampilkan Nilai

Mengembalikan TRUE pada keberhasilan, FALSE pada kegagalan.

Keterangan

Mengonversi ke bentuk kanonis melibatkan konversi karakter dan spasi yang tidak aman untuk meloloskan urutan.

CUrl::Clear

Panggil metode ini untuk menghapus semua bidang URL.

inline void Clear() throw();

CUrl::CrackUrl

Panggil metode ini untuk mendekode dan mengurai URL.

BOOL CrackUrl(LPCTSTR lpszUrl, DWORD dwFlags = 0) throw();

Parameter

lpszUrl
The URL.

dwFlags
Tentukan ATL_URL_DECODE atau ATL_URL_ESCAPE untuk mengonversi semua karakter escape di lpszUrl ke nilai sebenarnya setelah penguraian. (Sebelum Visual C++ 2005, ATL_URL_DECODE mengonversi semua karakter escape sebelum mengurai.)

Tampilkan Nilai

Mengembalikan TRUE pada keberhasilan, FALSE pada kegagalan.

CUrl::CreateUrl

Metode ini membuat string URL dari bidang komponen objek CUrl.

inline BOOL CreateUrl(
    LPTSTR lpszUrl,
    DWORD* pdwMaxLength,
    DWORD dwFlags = 0) const throw();

Parameter

lpszUrl
Buffer string untuk menahan string URL lengkap.

pdwMaxLength
Panjang maksimum buffer string lpszUrl .

dwFlags
Tentukan ATL_URL_ESCAPE untuk mengonversi semua karakter escape di lpszUrl ke nilai aslinya.

Tampilkan Nilai

Mengembalikan TRUE pada keberhasilan, FALSE pada kegagalan.

Keterangan

Metode ini menambahkan bidang individualnya untuk membuat string URL lengkap menggunakan format berikut:

<scheme>://<user>:<pass>@<domain>:<port><path><extra>

Saat memanggil metode ini, parameter pdwMaxLength awalnya harus berisi panjang maksimum buffer string yang dirujuk oleh parameter lpszUrl . Nilai parameter pdwMaxLength akan diperbarui dengan panjang string URL yang sebenarnya.

Contoh

Sampel ini menunjukkan pembuatan objek CUrl dan mengambil string URL-nya

CUrl url;

// Set the CUrl contents
url.CrackUrl(_T("http://someone:secret@www.microsoft.com:8080/visualc/stuff.htm#contents"));

// Obtain the length of the URL string and allocate a buffer to 
// hold its contents
DWORD dwUrlLen = url.GetUrlLength() + 1;
TCHAR* szUrl = new TCHAR[dwUrlLen];

// Retrieve the contents of the CUrl object
url.CreateUrl(szUrl, &dwUrlLen, 0L);

// Cleanup
delete[] szUrl;

CUrl::CUrl

Konstruktor.

CUrl() throw();
CUrl(const CUrl& urlThat) throw();

Parameter

urlThat
Objek CUrl yang akan disalin untuk membuat URL.

CUrl::~CUrl

Destruktor.

~CUrl() throw();

CUrl::GetExtraInfo

Panggil metode ini untuk mendapatkan informasi tambahan (seperti teks atau # teks) dari URL.

inline LPCTSTR GetExtraInfo() const throw();

Tampilkan Nilai

Mengembalikan string yang berisi informasi tambahan.

CUrl::GetExtraInfoLength

Panggil metode ini untuk mendapatkan panjang informasi tambahan (seperti teks atau # teks) untuk diambil dari URL.

inline DWORD GetExtraInfoLength() const throw();

Tampilkan Nilai

Mengembalikan panjang string yang berisi informasi tambahan.

CUrl::GetHostName

Panggil metode ini untuk mendapatkan nama host dari URL.

inline LPCTSTR GetHostName() const throw();

Tampilkan Nilai

Mengembalikan nama host.

CUrl::GetHostNameLength

Panggil metode ini untuk mendapatkan panjang nama host.

inline DWORD GetHostNameLength() const throw();

Tampilkan Nilai

Mengembalikan panjang nama host.

CUrl::GetPassword

Panggil metode ini untuk mendapatkan kata sandi dari URL.

inline LPCTSTR GetPassword() const throw();

Tampilkan Nilai

Mengembalikan kata sandi.

CUrl::GetPasswordLength

Panggil metode ini untuk mendapatkan panjang kata sandi.

inline DWORD GetPasswordLength() const throw();

Tampilkan Nilai

Mengembalikan panjang kata sandi.

CUrl::GetPortNumber

Panggil metode ini untuk mendapatkan nomor port.

inline ATL_URL_PORT GetPortNumber() const throw();

Tampilkan Nilai

Mengembalikan nomor port.

CUrl::GetScheme

Panggil metode ini untuk mendapatkan skema URL.

inline ATL_URL_SCHEME GetScheme() const throw();

Tampilkan Nilai

Mengembalikan nilai ATL_URL_SCHEME yang menjelaskan skema URL.

CUrl::GetSchemeName

Panggil metode ini untuk mendapatkan nama skema URL.

inline LPCTSTR GetSchemeName() const throw();

Tampilkan Nilai

Mengembalikan nama skema URL (seperti "http" atau "ftp").

CUrl::GetSchemeNameLength

Panggil metode ini untuk mendapatkan panjang nama skema URL.

inline DWORD GetSchemeNameLength() const throw();

Tampilkan Nilai

Mengembalikan panjang nama skema URL.

CUrl::GetUrlLength

Panggil metode ini untuk mendapatkan panjang URL.

inline DWORD GetUrlLength() const throw();

Tampilkan Nilai

Mengembalikan panjang URL.

CUrl::GetUrlPath

Panggil metode ini untuk mendapatkan jalur URL.

inline LPCTSTR GetUrlPath() const throw();

Tampilkan Nilai

Mengembalikan jalur URL.

CUrl::GetUrlPathLength

Panggil metode ini untuk mendapatkan panjang jalur URL.

inline DWORD GetUrlPathLength() const throw();

Tampilkan Nilai

Mengembalikan panjang jalur URL.

CUrl::GetUserName

Panggil metode ini untuk mendapatkan nama pengguna dari URL.

inline LPCTSTR GetUserName() const throw();

Tampilkan Nilai

Mengembalikan nama pengguna.

CUrl::GetUserNameLength

Panggil metode ini untuk mendapatkan panjang nama pengguna.

inline DWORD GetUserNameLength() const throw();

Tampilkan Nilai

Mengembalikan panjang nama pengguna.

CUrl::operator =

Menetapkan objek yang ditentukan CUrl ke objek saat ini CUrl .

CUrl& operator= (const CUrl& urlThat) throw();

Parameter

urlThat
Objek CUrl yang akan disalin ke objek saat ini.

Tampilkan Nilai

Mengembalikan referensi ke objek saat ini.

CUrl::SetExtraInfo

Panggil metode ini untuk mengatur informasi tambahan (seperti teks atau # teks) URL.

inline BOOL SetExtraInfo(LPCTSTR lpszInfo) throw();

Parameter

lpszInfo
String yang berisi informasi tambahan untuk disertakan dalam URL.

Tampilkan Nilai

Mengembalikan TRUE pada keberhasilan, FALSE pada kegagalan.

CUrl::SetHostName

Panggil metode ini untuk mengatur nama host.

inline BOOL SetHostName(LPCTSTR lpszHost) throw();

Parameter

lpszHost
Nama host.

Tampilkan Nilai

Mengembalikan TRUE pada keberhasilan, FALSE pada kegagalan.

CUrl::SetPassword

Panggil metode ini untuk mengatur kata sandi.

inline BOOL SetPassword(LPCTSTR lpszPass) throw();

Parameter

lpszPass
Kata sandi.

Tampilkan Nilai

Mengembalikan TRUE pada keberhasilan, FALSE pada kegagalan.

CUrl::SetPortNumber

Panggil metode ini untuk mengatur nomor port.

inline BOOL SetPortNumber(ATL_URL_PORT nPrt) throw();

Parameter

nPrt
Nomor port.

Tampilkan Nilai

Mengembalikan TRUE pada keberhasilan, FALSE pada kegagalan.

CUrl::SetScheme

Panggil metode ini untuk mengatur skema URL.

inline BOOL SetScheme(ATL_URL_SCHEME nScheme) throw();

Parameter

nScheme
Salah satu nilai ATL_URL_SCHEME untuk skema.

Tampilkan Nilai

Mengembalikan TRUE pada keberhasilan, FALSE pada kegagalan.

Keterangan

Anda juga dapat mengatur skema berdasarkan nama (lihat CUrl::SetSchemeName).

CUrl::SetSchemeName

Panggil metode ini untuk mengatur nama skema URL.

inline BOOL SetSchemeName(LPCTSTR lpszSchm) throw();

Parameter

lpszSchm
Nama skema URL.

Tampilkan Nilai

Mengembalikan TRUE pada keberhasilan, FALSE pada kegagalan.

Keterangan

Anda juga dapat mengatur skema dengan menggunakan konstanta ATL_URL_SCHEME (lihat CUrl::SetScheme).

CUrl::SetUrlPath

Panggil metode ini untuk mengatur jalur URL.

inline BOOL SetUrlPath(LPCTSTR lpszPath) throw();

Parameter

lpszPath
Jalur URL.

Tampilkan Nilai

Mengembalikan TRUE pada keberhasilan, FALSE pada kegagalan.

CUrl::SetUserName

Panggil metode ini untuk mengatur nama pengguna.

inline BOOL SetUserName(LPCTSTR lpszUser) throw();

Parameter

lpszUser
Nama pengguna.

Tampilkan Nilai

Mengembalikan TRUE pada keberhasilan, FALSE pada kegagalan.

Lihat juga

Kelas

Bagikan melalui

Kelas CUrl

Sintaks

Anggota

Konstruktor Publik

Metode Publik

Operator Publik

Keterangan

Persyaratan

CUrl::Canonicalize

Parameter

Tampilkan Nilai

Keterangan

CUrl::Clear

CUrl::CrackUrl

Parameter

Tampilkan Nilai

CUrl::CreateUrl

Parameter

Tampilkan Nilai

Keterangan

Contoh

CUrl::CUrl

Parameter

CUrl::~CUrl

CUrl::GetExtraInfo

Tampilkan Nilai

CUrl::GetExtraInfoLength

Tampilkan Nilai

CUrl::GetHostName

Tampilkan Nilai

CUrl::GetHostNameLength

Tampilkan Nilai

CUrl::GetPassword

Tampilkan Nilai

CUrl::GetPasswordLength

Tampilkan Nilai

CUrl::GetPortNumber

Tampilkan Nilai

CUrl::GetScheme

Tampilkan Nilai

CUrl::GetSchemeName

Tampilkan Nilai

CUrl::GetSchemeNameLength

Tampilkan Nilai

CUrl::GetUrlLength

Tampilkan Nilai

CUrl::GetUrlPath

Tampilkan Nilai

CUrl::GetUrlPathLength

Tampilkan Nilai

CUrl::GetUserName

Tampilkan Nilai

CUrl::GetUserNameLength

Tampilkan Nilai

CUrl::operator =

Parameter

Tampilkan Nilai

CUrl::SetExtraInfo

Parameter

Tampilkan Nilai

CUrl::SetHostName

Parameter

Tampilkan Nilai

CUrl::SetPassword

Parameter

Tampilkan Nilai

CUrl::SetPortNumber

Parameter

Tampilkan Nilai

CUrl::SetScheme

Parameter

Tampilkan Nilai

Keterangan

CUrl::SetSchemeName

Parameter

Tampilkan Nilai

Keterangan

CUrl::SetUrlPath

Parameter