include(module,namespace = None,app_name = None)[source]
include(pattern_list)
include((pattern_list,app_namespace),namespace = None)
include((pattern_list,app_namespace,instance_namespace))
一個函數,它將完整的Python導入路徑帶到另一個URLconf模塊,該模塊應該“包含”在這個地方。可選地,還可以指定將包括條目的應用程序命名空間和實例命名空間。
通常,應用程序命名空間應由包含的模塊指定。如果設置了應用程序命名空間,則該namespace參數可用於設置不同的實例命名空間。
include() 還接受返回URL模式的iterable,包含此類iterable的2元組加上應用程序命名空間的名稱,或包含iterable的3元組以及應用程序和實例命名空間的名稱作為參數。
參數:
- module - URLconf模塊(或模塊名稱)
- namespace(str) - 包含的URL條目的實例名稱空間
- app_name(str) - 包含的URL條目的應用程序命名空間
- pattern_list - 可重復django.conf.urls.url()實例
- app_namespace(str) - 包含的URL條目的應用程序名稱空間
- instance_namespace(str) - 包含的URL條目的實例名稱空間
從版本1.9開始 app_name不推薦使用:不推薦使用對該參數的支持,將在Django 2.0中刪除。指定URL名稱空間中的app_name說明, 並包含URLconf。
對於傳遞3元組的支持也已棄用,將在Django 2.0中刪除。傳遞包含模式列表和應用程序命名空間的2元組,並namespace改為使用參數。
最后,對不帶應用程序命名空間的實例命名空間的支持已被棄用,並將在Django 2.0中刪除。指定應用程序命名空間或刪除實例命名空間。